devdocs-mcp

KnowledgeBase MCP server for Developer Documentation

Installation

Quick Start with uvx (Recommended)

Run directly from GitHub with ML dependencies (required for semantic search):

uvx --from "devdocs-mcp[ml] @ git+https://github.com/HellButcher/devdocs-mcp.git" devdocs-mcp

MCP Server Configuration

Add to your MCP client configuration (e.g., Claude Desktop, Cline):

{
  "mcpServers": {
    "devdocs": {
      "command": "uvx",
      "args": [
        "--from",
        "devdocs-mcp[ml] @ git+https://github.com/HellButcher/devdocs-mcp.git",
        "devdocs-mcp"
      ]
    }
  }
}

Development Setup

Clone and install with ML dependencies:

git clone https://github.com/HellButcher/devdocs-mcp.git
cd devdocs-mcp
uv sync --extra ml
uv run devdocs-mcp

Install with locked dependency versions

uvx/uv tool install resolve dependencies fresh and don't use the repo's uv.lock. If you want the exact, tested dependency versions instead, clone the repo and use the provided install script, which exports uv.lock and installs the tool constrained to it:

git clone https://github.com/HellButcher/devdocs-mcp.git
cd devdocs-mcp
./install.sh            # with ML dependencies (semantic search)
./install.sh --no-ml    # without ML dependencies

# then just call devdocs-mcp to run it
devdocs-mcp

Features

Access to 819+ documentation sources from devdocs.io
Semantic search with vector embeddings (requires ML dependencies)
Custom local documentation sources
Efficient caching and incremental updates
10 MCP tools for documentation queries

Configuration

Configuration is stored at XDG paths:

Config: ~/.config/devdocs-mcp/config.json
Cache: ~/.cache/devdocs-mcp/ (docs + embeddings)

Environment variables:

DEVD_EMBEDDING_MODEL - Override the default embedding model