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
• Supports both stdio and HTTP/SSE transports

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"
    }
  }
}

Local HTTP mode

MCP_TRANSPORT=http PORT=3000 npx tsx src/index.ts

Verify with:

curl http://localhost:3000/health

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	Default	Description
MCP_TRANSPORT	stdio	Transport mode: http or stdio
PORT	3000	HTTP server port (only used when MCP_TRANSPORT=http)

Docker

Build

docker build -t dev-docs-mcp .

Run (HTTP mode)

docker run -p 3000:3000 dev-docs-mcp

Run (stdio mode)

docker run -i -e MCP_TRANSPORT=stdio 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)