Documentation Search MCP Server

MCP server for searching documentation, scanning dependencies for vulnerabilities, and generating project boilerplate. Works with Claude Desktop, Cursor, and other MCP clients.

**📚 Read the comprehensive tutorial** for detailed examples and workflows.

Features

• Search 190+ curated documentation sources with optional semantic vector search
• Scan Python projects for vulnerabilities (Snyk, Safety, OSV)
• Generate FastAPI and React project starters
• Learning paths and code examples

Installation

# Recommended: use uvx (install uv from https://docs.astral.sh/uv)
uvx documentation-search-enhanced@1.9.0

# Or with pip in a virtual environment
pip install documentation-search-enhanced==1.9.0

# Optional: AI semantic search (Python 3.12 only, adds ~600MB)
pip install documentation-search-enhanced[vector]==1.9.0

Configuration

Claude Desktop

Find your uvx path: `which uvx`

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

{
  "mcpServers": {
    "documentation-search-enhanced": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["documentation-search-enhanced@1.9.0"],
      "env": {
        "SERPER_API_KEY": "optional_key_here"
      }
    }
  }
}

Replace `/Users/yourusername/.local/bin/uvx` with your actual uvx path.

Codex CLI

# Find your uvx path first
which uvx

# Then add with full path (replace with your actual path)
codex mcp add documentation-search-enhanced \
  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0

# Or if uvx is in PATH:
codex mcp add documentation-search-enhanced \
  -- uvx documentation-search-enhanced@1.9.0

With SERPER API Key (enables live web search):

codex mcp add documentation-search-enhanced \
  --env SERPER_API_KEY=your_key_here \
  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0

Without SERPER API Key (uses prebuilt index from GitHub Releases):

codex mcp add documentation-search-enhanced \
  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0

If you get a timeout on first run, pre-download dependencies:

uvx documentation-search-enhanced@1.9.0

Environment Variables

• `SERPER_API_KEY` - Optional. Enables live web search. Without it, uses prebuilt index from GitHub Releases.
• `DOCS_SITE_INDEX_AUTO_DOWNLOAD` - Set to `false` to disable automatic index downloads
• `DOCS_SITE_INDEX_PATH` - Custom path for documentation index

Set `server_config.features.real_time_search=false` in your config to disable live crawling.

Semantic Search (Optional)

The `[vector]` extra adds semantic search using sentence-transformers (all-MiniLM-L6-v2) with hybrid reranking:

• 50% semantic similarity (cosine)
• 30% keyword matching
• 20% source authority

Only works on Python 3.12 (PyTorch limitation). Python 3.13 users get keyword-based search.

To disable vector search even when installed:

semantic_search(query="FastAPI auth", libraries=["fastapi"], use_vector_rerank=False)

Available Tools

Core MCP tools:

• `semantic_search` - Search documentation
• `get_docs` - Fetch specific documentation
• `get_learning_path` - Generate learning roadmap
• `get_code_examples` - Find code snippets
• `scan_project_dependencies` - Vulnerability scan
• `snyk_scan_project` - Detailed Snyk analysis
• `generate_project_starter` - Create project boilerplate
• `manage_dev_environment` - Generate docker-compose files
• `compare_library_security` - Compare library vulnerabilities

Development

git clone https://github.com/anton-prosterity/documentation-search-mcp.git
cd documentation-search-mcp
uv sync --all-extras
uv run python -m documentation_search_enhanced.main

Testing

uv run pytest --ignore=pytest-test-project  # Core tests
uv run ruff check src                       # Linting
uv run ruff format src --check              # Format check

Configuration

Use the `get_current_config` tool to export current settings to `config.json`. Validate with:

uv run python src/documentation_search_enhanced/config_validator.py

Contributing

See `CONTRIBUTING.md` for guidelines. Use Conventional Commits for commit messages.

License

MIT License - see `LICENSE` for details.