daedalus avatar

Mcp Smbmap

daedalus/mcp-smbmap

Wraps smbmap for SMB enumeration directly in Claude. You get tools to connect to Windows shares, list drives and directories, check signing status, and pull OS version info. Beyond reconnaissance, it exposes file operations like download, upload, and delete, plus remote command execution and admin rights checks. Reach for this when you're auditing network shares, investigating SMB configurations, or automating file transfers across Windows environments without leaving your AI workflow. The full smbmap toolkit becomes available as structured MCP tools instead of parsing command line output.

tools
12
transport
STDIO
last updated
Apr 9, 2026

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

connectConnect to an SMB host

Connect to an SMB host

No parameter schema in public metadata yet.

list_sharesList all shares on the target host

List all shares on the target host

No parameter schema in public metadata yet.

list_drivesList all drives on the target host

List all drives on the target host

No parameter schema in public metadata yet.

list_pathList contents of a share path

List contents of a share path

No parameter schema in public metadata yet.

get_versionGet OS version of the remote host

Get OS version of the remote host

No parameter schema in public metadata yet.

check_signingCheck SMB signing status

Check SMB signing status

No parameter schema in public metadata yet.

exec_commandExecute a command on the remote host

Execute a command on the remote host

No parameter schema in public metadata yet.

download_fileDownload a file from the remote system

Download a file from the remote system

No parameter schema in public metadata yet.

upload_fileUpload a file to the remote system

Upload a file to the remote system

No parameter schema in public metadata yet.

delete_fileDelete a remote file

Delete a remote file

No parameter schema in public metadata yet.

check_adminCheck if user has admin rights

Check if user has admin rights

No parameter schema in public metadata yet.

disconnectDisconnect from an SMB host

Disconnect from an SMB host

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-smbmap

MCP server exposing smbmap SMB enumeration functionality.

PyPI Python

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/

View the full README on GitHub

Details

Repository
github.com/daedalus/mcp-smbmap
Package
mcp-smbmap
Transport
STDIO
Registry
MCP registry, active

More from daedalus