Enhanced Documentation Search

Documentation Search MCP Server

Servidor MCP para pesquisar documentação, escanear dependências em busca de vulnerabilidades e gerar boilerplate de projetos. Funciona com Claude Desktop, Cursor e outros clientes MCP.

📚 Leia o tutorial abrangente para exemplos detalhados e fluxos de trabalho.

Recursos

• Pesquise em mais de 190 fontes de documentação selecionadas com busca vetorial semântica opcional
• Escaneie projetos Python em busca de vulnerabilidades (Snyk, Safety, OSV)
• Gere iniciadores de projetos FastAPI e React
• Caminhos de aprendizado e exemplos de código

Instalação

# 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

Configuração

Claude Desktop

Encontre seu caminho uvx: which uvx

Edite ~/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"
      }
    }
  }
}

Substitua /Users/yourusername/.local/bin/uvx pelo seu caminho uvx real.

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

Com chave de API SERPER (habilita busca web ao vivo):

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

Sem chave de API SERPER (usa índice pré-construído dos lançamentos do GitHub):

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

Se você tiver um timeout na primeira execução, pré-baixe as dependências:

uvx documentation-search-enhanced@1.9.0

Variáveis de Ambiente

• SERPER_API_KEY - Opcional. Habilita busca web ao vivo. Sem ele, usa índice pré-construído dos lançamentos do GitHub.
• DOCS_SITE_INDEX_AUTO_DOWNLOAD - Defina como false para desabilitar downloads automáticos de índice
• DOCS_SITE_INDEX_PATH - Caminho personalizado para o índice de documentação

Defina server_config.features.real_time_search=false na sua configuração para desabilitar o rastreamento ao vivo.

Busca Semântica (Opcional)

O extra [vector] adiciona busca semântica usando sentence-transformers (all-MiniLM-L6-v2) com reclassificação híbrida:

• 50% similaridade semântica (cosseno)
• 30% correspondência de palavras-chave
• 20% autoridade da fonte

Funciona apenas em Python 3.12 (limitação do PyTorch). Usuários de Python 3.13 obtêm busca baseada em palavras-chave.

Para desabilitar a busca vetorial mesmo quando instalado:

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

Ferramentas Disponíveis

Ferramentas MCP principais:

• semantic_search - Pesquisar documentação
• get_docs - Buscar documentação específica
• get_learning_path - Gerar roteiro de aprendizado
• get_code_examples - Encontrar trechos de código
• scan_project_dependencies - Escaneamento de vulnerabilidades
• snyk_scan_project - Análise detalhada do Snyk
• generate_project_starter - Criar boilerplate de projeto
• manage_dev_environment - Gerar arquivos docker-compose
• compare_library_security - Comparar vulnerabilidades de bibliotecas

Desenvolvimento

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

Testes

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

Configuração

Use a ferramenta get_current_config para exportar as configurações atuais para config.json. Valide com:

uv run python src/documentation_search_enhanced/config_validator.py

Contribuindo

Veja CONTRIBUTING.md para diretrizes. Use Conventional Commits para mensagens de commit.

Licença

Licença MIT - veja LICENSE para detalhes.