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