# mcp-smbmap

MCP server exposing smbmap SMB enumeration functionality.

[![PyPI](https://img.shields.io/pypi/v/mcp-smbmap.svg)](https://pypi.org/project/mcp-smbmap/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-smbmap.svg)](https://pypi.org/project/mcp-smbmap/)

## Install

```bash
pip install mcp-smbmap
```

## Usage

```python
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

```bash
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