git clone https://github.com/lotsonlu/ssr-mcp-server.git
cd ssr-mcp-server
pip install -r requirements.txt

export SSR_BASE_URL="https://<your-conductor-ip>"
export SSR_USERNAME="admin"
export SSR_PASSWORD="your-password"

{
    "conductor": {
        "base_url": "https://172.27.69.57",
        "username": "admin",
        "password": "your-password",
        "timeout": 120,
        "verify_ssl": false
    }
}

{
  "mcpServers": {
    "ssr-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["/path/to/ssr_mcp.py", "-f", "/path/to/config.json", "-t", "stdio"]
    }
  }
}

{
  "mcpServers": {
    "ssr-mcp": {
      "command": "python3",
      "args": ["/path/to/ssr_mcp.py", "-f", "/path/to/config.json", "-t", "stdio"]
    }
  }
}

python ssr_mcp.py -H 0.0.0.0 -p 8080 -t streamable-http

docker build -t ssr-mcp-server .
docker run --rm -i \
  -e SSR_BASE_URL="https://<conductor-ip>" \
  -e SSR_USERNAME="admin" \
  -e SSR_PASSWORD="your-password" \
  ssr-mcp-server -t stdio

┌──────────────────────────────────────────────┐
│  Claude Desktop / VSCode / Other MCP Clients │
└──────────────────┬───────────────────────────┘
                   │ stdio / streamable-http
┌──────────────────▼───────────────────────────┐
│  SSR MCP Server (ssr_mcp_server)             │
│  ├── server.py     MCP Server & Tool Defs    │
│  ├── ssr_client.py REST API Client           │
│  ├── tools/        22 Tool Handlers          │
│  └── utils/        Config Management         │
└──────────────────┬───────────────────────────┘
                   │ REST API (HTTPS)
┌──────────────────▼───────────────────────────┐
│  SSR Conductor                               │
│  /router, /alarm, /traffic, /stats, etc.     │
└──────────────────────────────────────────────┘

ssr-mcp-server/
├── ssr_mcp.py                    # CLI entry point
├── ssr_mcp_server/               # Core package
│   ├── server.py                 # MCP server & 22 tool definitions
│   ├── ssr_client.py             # REST API client (auth, HTTP, retry)
│   ├── tools/                    # Tool handler modules
│   │   ├── router_tools.py       # Router & system tools
│   │   ├── alarm_tools.py        # Alarm & status tools
│   │   ├── traffic_tools.py      # Traffic & routing tools
│   │   ├── interface_tools.py    # Interface & service tools
│   │   ├── metrics_tools.py      # Metrics & analytics tools
│   │   └── audit_tools.py        # Audit & version tools
│   └── utils/
│       └── config.py             # Configuration management
├── pyproject.toml                # Project metadata & dependencies
├── requirements.txt              # Pip dependencies
├── Dockerfile                    # Docker build
├── Makefile                      # Dev/build helpers
├── config-template.json          # Configuration template
└── LICENSE

# Install dependencies
pip install -r requirements.txt

# Run with stdio transport
python ssr_mcp.py -t stdio

# Run tests
python -m pytest tests/

# Build Docker image
docker build -t ssr-mcp-server .