stubborn-mcp 0.1.0b1

MCP server for Stubborn — deterministic code context from SCIP symbol graphs

stubborn-mcp

MCP server for Stubborn — exposes get_context, list_symbols, and metrics to Cursor and other MCP clients.

Thin adapter over stubborn.api. All compile logic lives in stubborn-stub.

Part of the stubborn-ai program — see stubborn-hub.

Install

pip install stubborn-mcp

Requires a SCIP-derived symbols.db — build with the core compiler:

pip install stubborn-stub
stubborn index --scip index.scip --out metadata/symbols.db

Run

export STUBBORN_DB=/path/to/metadata/symbols.db
stubborn-mcp

Cursor configuration

.cursor/mcp.json:

{
  "mcpServers": {
    "stubborn": {
      "command": "stubborn-mcp",
      "env": {
        "STUBBORN_DB": "${workspaceFolder}/metadata/symbols.db"
      }
    }
  }
}

Module entry: python -m stubborn_mcp

Tools

Tool	Purpose
get_context	Prune + weave LLM context (java-stub or stubborn-dsl)
list_symbols	Browse/search symbols by stable_id
metrics	Compression KPI vs source tree

Full parameter reference: docs/MCP.md · stubborn MCP docs

Development

git clone https://github.com/stubborn-ai/stubborn-mcp.git
cd stubborn-mcp
pip install -e "../stubborn"
pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.