Mcp Smbmap

io.github.daedalusPublished by GitHub account daedalusv0.1.2Updated Oct 24, 2026

MCP server exposing smbmap SMB enumeration functionality

VerifiedSTDIODesktop onlyFiles & StorageSecurity & Monitoring

Overview

AI-generated overview

A local MCP server that wraps smbmap so an assistant can enumerate SMB hosts, list shares and paths, and transfer or delete remote files.

What you can do
Connect to and disconnect from SMB hosts, and check admin rights on them. List shares, drives and directory contents on a target host. Read the remote OS version and SMB signing status. Execute commands on the remote host. Download, upload and delete files on the remote system.
When to use it
Useful for authorized SMB enumeration and file-management work, such as auditing shares, checking signing and admin access, or moving files on a Windows file server from within an assistant session.
Requirements
Runs as a local process installed from the PyPI package mcp-smbmap, so Python and pip are needed. Network access to the target SMB hosts is required. No environment variables, headers or authentication are declared by the manifest.
Before you install
The tools can execute commands and upload or delete files on remote hosts, which changes data and can be destructive. Only point it at systems you are authorized to test. Credentials for SMB targets are not declared in the manifest, so check how the server obtains them before use.

Installation

In SourceWeft

  1. Open Mcp Smbmap in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-smbmap

MCP server exposing smbmap SMB enumeration functionality.

[PyPI] [Python]

Install

bash
pip install mcp-smbmap

Usage

python
from mcp_smbmap import mcp
# Run the MCP servermcp.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

bash
git clone https://github.com/daedalus/mcp-smbmap.gitcd mcp-smbmappip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

MCP Name

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

Source: README.md at commit 85d27a7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts