MCP Server

August 12, 2026 ยท View on GitHub

SkillRoute includes a TypeScript stdio MCP server that wraps the Python bridge.

Build

cd mcp
npm install
npm run build

Or run the full local bootstrap:

./scripts/bootstrap.sh

Client Setup

Generate reviewed setup for your agent client:

uv run skillroute mcp config --client ibm-bob
uv run skillroute mcp config --client codex
uv run skillroute mcp config --client claude-code
uv run skillroute mcp config --client claude-desktop
uv run skillroute mcp config --client vscode
uv run skillroute mcp config --client windsurf
uv run skillroute mcp config --client cursor

See Agent Setup for client-specific paths, scopes, and plugin packaging notes.

Run

node build/index.js

The server sets PYTHONPATH to the repo src directory for local development and invokes:

python3 -m skillroute bridge <operation>

Tools

skillroute.route

Inputs:

  • request
  • repo optional
  • catalog optional
  • backend optional: local, fts5, or astra
  • limit optional

Returns ranked skills, reasons, confidence, evidence snippets, suggested order, and clarification questions.

skillroute.search

Inputs:

  • query
  • catalog optional
  • backend optional: local, fts5, or astra
  • limit optional

Returns search rows with lexical/backend scores and evidence snippets.

skillroute.inspect_skill

Inputs:

  • skill_id
  • catalog optional

Returns metadata, facets, relationships, excerpts, references, and backend refs.

Smoke Test

cd mcp
npm run smoke