mcp-monitor-local-sdk

Self-host monitoring SDK for Python MCP servers. User guide · Developer guide

Repo copies: USER.md · DEV.md

User guide

Point this SDK at your self-host API (metrics_server_url + instance_secret). It wraps tool handlers and sends tool-call metrics (name, duration, success/error) — not application logs — to POST /v1/metrics. Open the local UI or desktop app to see them. This package does not talk to the hosted dashboard.

pip install mcp-monitor-local-sdk

from mcp_monitor_sdk import MonitoredFastMCP

server = MonitoredFastMCP(
    "todo-mcp",
    server_name="todo-mcp",
    instance_secret="change-me-to-a-long-random-secret",
    metrics_server_url="http://localhost:8000/v1/metrics",
)

@server.tool()
def todos_list() -> str:
    """List all todos."""
    return "No todos."

if __name__ == "__main__":
    server.run()

instance_secret must match INSTANCE_SECRET on the API.

Developer guide

Same ingest contract as the JS SDK. Built to sit next to the official mcp package.

Options

Events flush when the batch is full or every flush_interval_ms. Failed flushes are restored. Shutdown drains remaining events.

Local checkout:

pip install -e ./local/sdk/py

Publish:

cd local/sdk/py
python -m build
twine upload dist/*