README.md

---
title: snap-python MCP Service
emoji: 🔧
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: mit
---

# snap-python MCP Service

This deployment package wraps SNAP (Stanford Network Analysis Platform) Python functionality into a FastMCP service.

## Available Tools

- `adapter_health`
- `list_modules`
- `generate_graph`
- `graph_info`
- `basic_metrics`
- `connectivity_metrics`
- `degree_distribution`
- `call_snap_function`

Detailed parameter documentation and examples are in `snap-python/mcp_output/README_MCP.md`.

## Local stdio usage (Claude Desktop / CLI)

```bash
cd snap-python/mcp_output
python start_mcp.py
```

or:

```bash
cd snap-python/mcp_output/mcp_plugin
python main.py
```

Default transport is `stdio`.

## HTTP client usage

```bash
cd snap-python/mcp_output
MCP_TRANSPORT=http MCP_PORT=8000 python start_mcp.py
```

Clients connect to:

```text
http://localhost:8000/mcp
```

## Docker / HuggingFace Spaces

Docker entry point runs FastMCP directly:

```text
python snap-python/mcp_output/start_mcp.py
```

With environment:

- `MCP_TRANSPORT=http`
- `MCP_PORT=7860`

Client endpoint:

```text
https://<your-space-host>/mcp
```