mcp server
mcp-smbmap
MCP server exposing smbmap SMB enumeration functionality.
Set up
Runs on your computer. Pick your agent and operating system.
Before you start
- uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
{
"mcpServers": {
"mcp-smbmap": {
"command": "uvx",
"args": [
"mcp-smbmap"
]
}
}
}same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12
Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs
README
synced Oct 17, 2026mcp-smbmap
MCP server exposing smbmap SMB enumeration functionality.
Install
pip install mcp-smbmap
Usage
from mcp_smbmap import mcp
# Run the MCP server
mcp.run()
MCP Tools
connect- Connect to an SMB hostlist_shares- List all shares on the target hostlist_drives- List all drives on the target hostlist_path- List contents of a share pathget_version- Get OS version of the remote hostcheck_signing- Check SMB signing statusexec_command- Execute a command on the remote hostdownload_file- Download a file from the remote systemupload_file- Upload a file to the remote systemdelete_file- Delete a remote filecheck_admin- Check if user has admin rightsdisconnect- Disconnect from an SMB host
Development
git clone https://github.com/daedalus/mcp-smbmap.git
cd mcp-smbmap
pip install -e ".[test]"
# run tests
pytest
# format
ruff format src/ tests/
# lint
ruff check src/ tests/
# type check
mypy src/
MCP Name
mcp-name: io.github.daedalus/mcp-smbmap