Enhanced Documentation Search

Servidor MCP de Búsqueda de Documentación

Servidor MCP para buscar documentación, escanear dependencias en busca de vulnerabilidades y generar plantillas de proyectos. Funciona con Claude Desktop, Cursor y otros clientes MCP.

📚 Lea el tutorial completo para ejemplos detallados y flujos de trabajo.

Características

• Busca en más de 190 fuentes de documentación seleccionadas con búsqueda vectorial semántica opcional
• Escanea proyectos Python en busca de vulnerabilidades (Snyk, Safety, OSV)
• Genera plantillas de inicio para proyectos FastAPI y React
• Rutas de aprendizaje y ejemplos de código

Instalación

# 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

Configuración

Claude Desktop

Encuentre su ruta 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"
      }
    }
  }
}

Reemplace /Users/yourusername/.local/bin/uvx con su ruta 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

Con clave API de SERPER (habilita la búsqueda web en 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

Sin clave API de SERPER (utiliza índice precompilado de GitHub Releases):

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

Si obtiene un tiempo de espera en la primera ejecución, descargue previamente las dependencias:

uvx documentation-search-enhanced@1.9.0

Variables de entorno

• SERPER_API_KEY - Opcional. Habilita la búsqueda web en vivo. Sin él, utiliza índice precompilado de GitHub Releases.
• DOCS_SITE_INDEX_AUTO_DOWNLOAD - Establezca a false para deshabilitar descargas automáticas de índice
• DOCS_SITE_INDEX_PATH - Ruta personalizada para el índice de documentación

Establezca server_config.features.real_time_search=false en su configuración para deshabilitar el rastreo en vivo.

Búsqueda semántica (Opcional)

El extra [vector] agrega búsqueda semántica usando sentence-transformers (all-MiniLM-L6-v2) con reordenamiento híbrido:

• 50% similitud semántica (coseno)
• 30% coincidencia de palabras clave
• 20% autoridad de la fuente

Solo funciona en Python 3.12 (limitación de PyTorch). Los usuarios de Python 3.13 obtienen búsqueda basada en palabras clave.

Para deshabilitar la búsqueda vectorial incluso cuando está instalado:

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

Herramientas disponibles

Herramientas MCP principales:

• semantic_search - Buscar documentación
• get_docs - Obtener documentación específica
• get_learning_path - Generar ruta de aprendizaje
• get_code_examples - Encontrar fragmentos de código
• scan_project_dependencies - Escaneo de vulnerabilidades
• snyk_scan_project - Análisis detallado de Snyk
• generate_project_starter - Crear plantilla de proyecto
• manage_dev_environment - Generar archivos docker-compose
• compare_library_security - Comparar vulnerabilidades de librerías

Desarrollo

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

Pruebas

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

Configuración

Use la herramienta get_current_config para exportar la configuración actual a config.json. Valide con:

uv run python src/documentation_search_enhanced/config_validator.py

Contribuciones

Consulte CONTRIBUTING.md para las pautas. Use Conventional Commits para los mensajes de confirmación.

Licencia

Licencia MIT - consulte LICENSE para más detalles.