Lineage Server

MCP server for the Lineage API using Python, uv, and pyproject.

References

• MCP Overview
• Transports (Streamable HTTP)
• MCP Python SDK
• Lineage SDK (PyPI)

Quickstart (dev)

• Env
  • cp .env.example .env and set LINEAGE_PASSPHRASE. Optional: MCP_ALLOW_ORIGINS=*, hosts.
• Install
  • uv venv -p 3.11 .venv && source .venv/bin/activate
  • uv sync --extra dev
  • uv pip install -e .
• Run
  • uv run uvicorn lineage_mcp.server:app --host 0.0.0.0 --port 8000
• Test
  • uv run pytest -q
• MCP Inspector (install & run)
  • Requires Node.js 18+ or Docker.
  • Option A (npx, no install):
    • npx @modelcontextprotocol/inspector@latest
  • Option B (global install):
    • npm install -g @modelcontextprotocol/inspector
    • mcp-inspector
  • Option C (Docker):
    • docker run --rm -p 5173:5173 ghcr.io/modelcontextprotocol/inspector:latest
  • In the Inspector UI, add a server:
    • Transport: Streamable HTTP
    • URL: http://localhost:8000/mcp
    • If using dev auth: set MCP_DEV_AUTH_TOKEN on the server and provide Authorization: Bearer <token> in Inspector requests.
  • Try tools: wallet.generate_seed_phrase, wallet.generate_keypair, wallet.get_balance, blockchain.get_latest_block, health, version.

Links

• Lineage Foundation
• Other SDKs – sdk-python, sdk-php, sdk-js, sdk-laravel