mcp-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 host
• list_shares - List all shares on the target host
• list_drives - List all drives on the target host
• list_path - List contents of a share path
• get_version - Get OS version of the remote host
• check_signing - Check SMB signing status
• exec_command - Execute a command on the remote host
• download_file - Download a file from the remote system
• upload_file - Upload a file to the remote system
• delete_file - Delete a remote file
• check_admin - Check if user has admin rights
• disconnect - 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