mcpField
M
mcp-smbmap

mcp-smbmap

Local
github.com/daedalusSecurity0Updated 27w ago
Repository

About mcp-smbmap

mcp-smbmap exposes SMB enumeration and file operations through an MCP server. It is intended for users inspecting an SMB host, its shares, access status, and remote files.

Key features

  1. 01Connect to and disconnect from SMB hosts
  2. 02List shares, drives, and share-path contents
  3. 03Retrieve remote OS version and SMB signing status
  4. 04Check whether a user has admin rights
  5. 05Run remote commands and transfer or delete files

Use cases

  1. 01Inspect shares and paths on an SMB host
  2. 02Check host version, signing, and user privileges
  3. 03Transfer or remove files on a remote system

MCP support

It exposes SMB host connection, enumeration, command execution, and file-operation tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "daedalus-mcp-smbmap": {
      "command": "uvx",
      "args": [
        "mcp-smbmap"
      ]
    }
  }
}
Run commanduvx mcp-smbmap

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-smbmap0.1.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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/

# lint
ruff check src/ tests/

# type check
mypy src/

MCP Name

mcp-name: io.github.daedalus/mcp-smbmap

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.