dev-docs-mcp

MCP server for semantic search over the Tripletex Development Documentation.

Clones the documentation repo, chunks markdown files by headings, generates local embeddings using Xenova/all-MiniLM-L6-v2, and exposes search via MCP tools.

Features

• Semantic search across all development documentation
• Local embeddings (no external API calls)
• Embedding cache keyed by git commit hash
• Stdio transport for MCP integration

Quick start

Via MCP Gateway (hosted)

The server is deployed as a Docker container behind the Tripletex MCP Gateway. No local setup needed — connect through the gateway.

Local stdio (Claude Code)

npm install
npm start

Or add to your .mcp.json:

{
  "mcpServers": {
    "dev-docs": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/dev-docs-mcp"
    }
  }
}

Available tools

Tool	Description
searchDocs	Semantic search over documentation. Accepts query (string) and optional topK (1-20, default 5).
listDocPages	Lists all documentation pages and their sections.

Environment variables

Variable	Description
GITHUB_TOKEN	GitHub token for cloning the private Development-Documentation repo

Docker

Build

docker build -t dev-docs-mcp .

Run

docker run -i -e GITHUB_TOKEN=<your-token> dev-docs-mcp

Development

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm run typecheck    # Type-check without emitting
npm start            # Run in stdio mode (dev)