CodeAlive MCP

Proporciona búsqueda semántica de código y funciones de interacción con la base de código a través de la API de CodeAlive.

GitHub

Prueba este MCPPatrocinado

Documentación

CodeAlive MCP: El motor de contexto más profundo para tus proyectos (especialmente para bases de código grandes)

¡Conecta tu asistente de IA a la potente plataforma de comprensión de código de CodeAlive en segundos!

Este servidor MCP (Model Context Protocol) permite que clientes de IA como Claude Code, Cursor, Claude Desktop, Continue, VS Code (GitHub Copilot), Cline, Codex, OpenCode, SourceCraft Code Assistant, SourceCraft CLI, Zed, KodaCode, GigaCode, Qwen Code, Gemini CLI, Roo Code, Goose, Kilo Code, Windsurf, Kiro, Qoder, n8n y Amazon Q Developer accedan a las funciones avanzadas de búsqueda semántica de código e interacción con bases de código de CodeAlive.

¿Qué es CodeAlive?

CodeAlive es un motor de contexto para bases de código grandes, impulsado por recuperación basada en grafos y expuesto a través de MCP. Proporciona a agentes de IA como Cursor, Claude Code, Codex y otras herramientas compatibles con MCP un contexto preciso del repositorio en lugar de obligarlos a leer archivos a ciegas. En nuestro benchmark RepoQA, CodeAlive + Qwen3.6 deep alcanzó calidad de agente de frontera con un costo de modelo ~25 veces menor, y la búsqueda semántica redujo los tokens capturados en un 45%.

Es como Context7, pero para tus bases de código (grandes).

Permite que los agentes de codificación con IA:

Encuentren código relevante más rápido con búsqueda semántica
Comprendan el panorama general más allá de archivos aislados
Proporcionen mejores respuestas con contexto completo del proyecto
Reduzcan costos y tiempo eliminando conjeturas

🛠 Herramientas disponibles

Una vez conectado, tendrás acceso a estas potentes herramientas:

get_data_sources - Lista tus repositorios y espacios de trabajo indexados
semantic_search - Búsqueda semántica canónica en artefactos indexados
grep_search - Búsqueda de texto exacta literal o con regex dentro del contenido de archivos, además de coincidencia literal de nombre de archivo/ruta (devuelve archivos como Form.xml incluso cuando su contenido nunca menciona el nombre), con vistas previas a nivel de línea para coincidencias de contenido
get_repository_ontology - Obtén orientación a nivel de repositorio para un repositorio seleccionado
get_file_tree - Inspecciona un árbol de archivos limitado para un repositorio
read_file - Lee una ruta de archivo relativa al repositorio, opcionalmente con un rango de líneas
fetch_artifacts - Carga el código fuente completo para resultados de búsqueda relevantes (los identificadores faltantes o inaccesibles se informan, no se descartan silenciosamente)
get_artifact_relationships - Expande el grafo de llamadas, la herencia y las relaciones de referencia para un artefacto
get_artifact_query_schema - Inspecciona las entidades, campos y ejemplos de ArtifactQuery compatibles
query_artifact_metadata - Ejecuta análisis de metadatos de solo lectura en repositorios seleccionados
chat - Preguntas y respuestas sintetizadas sobre la base de código, sin estado y más lentas; llama solo cuando se solicite explícitamente

🎯 Ejemplos de uso

Después de la configuración, prueba estos comandos con tu asistente de IA:

"Muéstrame todos los repositorios disponibles" → Usa get_data_sources
"Encuentra el código de autenticación en el servicio de usuario" → Usa semantic_search
"Encuentra el regex exacto que coincide con tokens JWT" → Usa grep_search
"Explica cómo funciona el flujo de pagos en esta base de código" → Generalmente comienza con semantic_search/grep_search, luego opcionalmente usa chat

semantic_search y grep_search deberían ser las herramientas predeterminadas para la mayoría de los agentes. chat es un respaldo de síntesis sin estado más lento que puede tardar considerablemente más que la recuperación, y generalmente es innecesario cuando un agente puede ejecutar un flujo de trabajo de múltiples pasos con ontología, búsqueda, obtención/lectura, relaciones, ArtifactQuery y lecturas de archivos locales. Si tu agente admite subagentes, la ruta de mayor confianza es delegar a un subagente enfocado que orqueste semantic_search y grep_search primero.

📚 Habilidad del agente

Para una experiencia aún mejor, instala la Habilidad del agente CodeAlive junto con el servidor MCP. El servidor MCP le da a tu agente acceso a las herramientas de CodeAlive; la habilidad le enseña los mejores flujos de trabajo y patrones de consulta para usarlas de manera efectiva.

Para la mayoría de los agentes (Cursor, Copilot, Gemini CLI, Codex y más de 30 otros) — instala la habilidad:

npx skills add CodeAlive-AI/codealive-skills@codealive-context-engine

Para Claude Code — instala el plugin (recomendado), que incluye la habilidad más mejoras específicas de Claude:

/plugin marketplace add CodeAlive-AI/codealive-skills
/plugin install codealive@codealive-marketplace

Tabla de contenido

Habilidad del agente
Inicio rápido (remoto)
Integraciones de clientes de IA
Avanzado: desarrollo local
Plugins de la comunidad
Implementación HTTP (autohospedado y nube)
Windows y WSL
Herramientas disponibles
Ejemplos de uso
Solución de problemas
Publicación en el registro MCP
Licencia

🚀 Inicio rápido (remoto)

La forma más rápida de comenzar - ¡no se requiere instalación! Nuestro servidor MCP remoto en https://mcp.codealive.ai/api proporciona acceso instantáneo a las capacidades de CodeAlive.

Paso 1: obtén tu clave de API

Regístrate en https://app.codealive.ai/
Navega a MCP y API
Haz clic en "+ Crear clave de API"
Copia tu clave de API inmediatamente: ¡no la volverás a ver!

Paso 2: abre la guía de tu cliente

Elige tu cliente en las guías de integración de MCP y sigue las instrucciones de configuración actuales allí.

🚀 Inicio rápido (instalación agéntica)

Puedes pedirle a tu agente de IA que instale el servidor MCP de CodeAlive por ti.

Copia y pega el siguiente mensaje en tu agente de IA. No incluyas tu clave de API en el mensaje:

Add the CodeAlive MCP server by following the guide for my client at https://docs.codealive.ai/integrations/mcp

Prefer the Remote HTTP option when available. Do not ask me to paste an API key into chat. When the key is needed, ask me to create a CodeAlive API key and copy it to my clipboard. After I confirm, insert it directly from the clipboard into the required secure configuration without displaying, echoing, logging, or exposing it in command arguments, command output, or model context. If you cannot safely use the clipboard without exposing the value, tell me exactly where to paste it myself.

Luego permite la ejecución.

Reinicia tu agente de IA.

🤖 Integraciones de clientes de IA

La configuración específica del cliente se mantiene en la documentación de CodeAlive para que las rutas de archivos, los transportes y la guía de autenticación se mantengan actualizados.

Comienza aquí: guías de integración de MCP

Cliente	Guía de configuración
Claude Code	Claude Code
Claude Desktop	Claude Desktop
Cursor	Cursor
Visual Studio Code	VS Code
Windsurf	Windsurf
Cline	Cline
Continue	Continue
Codex	Codex
Gemini CLI	Gemini CLI
Amazon Q Developer	Amazon Q
OpenCode	OpenCode
SourceCraft Code Assistant y SourceCraft CLI	SourceCraft
Zed	Zed
ChatGPT	ChatGPT
OpenClaw	OpenClaw
KodaCode, GigaCode, Roo Code, Goose, Kilo Code, Qwen Code, Kiro, Qoder, JetBrains AI Assistant, n8n y más	Otros agentes

Para un cliente no listado, usa estos detalles de conexión genéricos y adáptalos al formato de configuración MCP del cliente:

Endpoint: https://mcp.codealive.ai/api
Transporte: HTTP transmisible
Encabezado de autenticación: Authorization: Bearer YOUR_API_KEY_HERE

Para una implementación privada, reemplaza el endpoint con la URL /api de tu servidor. Consulta Autohospedaje para obtener orientación sobre la implementación.

Conectar el servidor es la mitad de la configuración. Los agentes de codificación pueden continuar usando su búsqueda integrada a menos que las instrucciones del proyecto les indiquen preferir CodeAlive. Las reglas listas para AGENTS.md, CLAUDE.md y los archivos de instrucciones específicos del cliente están en Instrucciones para agentes de codificación.

🔧 Avanzado: desarrollo local

Para desarrolladores que quieran personalizar o contribuir al servidor MCP.

Requisitos previos

Python 3.11+
uv (recomendado) o pip

Instalación

# Clone the repository
git clone https://github.com/CodeAlive-AI/codealive-mcp.git
cd codealive-mcp

# Setup with uv (recommended)
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

# Or setup with pip
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate  
pip install -e .

Configuración del servidor local

Después de instalar el servidor localmente, apunta tu cliente MCP a .venv/bin/python con src/codealive_mcp_server.py como primer argumento y proporciona CODEALIVE_API_KEY en el entorno del proceso. La configuración específica del cliente pertenece a las guías de integración de MCP.

Ejecutar el servidor HTTP localmente

# Start local HTTP server
export CODEALIVE_API_KEY="your_api_key_here"
python src/codealive_mcp_server.py --transport http --host localhost --port 8000

# Test health endpoint
curl http://localhost:8000/health

El transporte HTTP valida Host y los encabezados de Origin del navegador. Los hosts de bucle local (localhost, 127.0.0.1, ::1) funcionan sin configuración adicional. Para un nombre de host compartido, configura una lista de permitidos exacta:

export CODEALIVE_MCP_ALLOWED_HOSTS="mcp.codealive.yourcompany.com"
# Only for browser callers; ordinary MCP clients do not send Origin.
export CODEALIVE_MCP_ALLOWED_ORIGINS="https://mcp.codealive.yourcompany.com"
python src/codealive_mcp_server.py --transport http --host 0.0.0.0 --port 8000

Las opciones CLI repetibles equivalentes son --allowed-host y --allowed-origin. No uses * para un servidor orientado a Internet.

Prueba de tu instalación local

Después de hacer cambios, verifica rápidamente que todo funcione:

# Match pyproject.toml exactly; older uv versions reject the locked setup.
uv --version  # expected: uv 0.11.28
uv sync --locked --extra test

# Install the repository pre-push dependency audit once per clone
./scripts/setup-hooks.sh

# Quick smoke test (recommended)
make smoke-test

# Or run directly
python smoke_test.py

# With your API key for full testing
CODEALIVE_API_KEY=your_key python smoke_test.py

# Run unit tests
make unit-test

# Run all tests
make test

# Equivalent direct locked test run
uv run pytest src/tests/ -q

La prueba de humo verifica:

El servidor se inicia y se conecta correctamente
Todas las herramientas están registradas
Cada herramienta responde adecuadamente
La validación de parámetros funciona
Se ejecuta en ~5 segundos

🌐 Plugins de la comunidad

🚢 Implementación HTTP (autohospedado y nube)

Implementa el servidor MCP como un servicio HTTP para acceso a nivel de equipo o integración con instancias de CodeAlive autohospedadas.

Opciones de implementación

El servidor MCP de CodeAlive se puede implementar como un servicio HTTP usando Docker. Esto permite que múltiples clientes de IA se conecten a una única instancia compartida y habilita la integración con implementaciones de CodeAlive autohospedadas.

Docker Compose (recomendado)

Crea un archivo docker-compose.yml basado en nuestro ejemplo:

# Download the example
curl -O https://raw.githubusercontent.com/CodeAlive-AI/codealive-mcp/main/docker-compose.example.yml
mv docker-compose.example.yml docker-compose.yml

# Edit configuration (see below)
nano docker-compose.yml

# Start the service
docker compose up -d

# Check health
curl http://localhost:8000/health

Opciones de configuración:

Para CodeAlive Cloud (predeterminado):
- Elimina la variable de entorno CODEALIVE_BASE_URL (usa el https://app.codealive.ai predeterminado)
- Para clientes remotos con soporte OAuth, configura solo https://mcp.codealive.ai/api y completa el inicio de sesión del navegador cuando se te solicite
- Los clientes existentes con clave de API siguen siendo compatibles mediante Authorization: Bearer YOUR_KEY
Para CodeAlive autohospedado:
- Establece CODEALIVE_BASE_URL en la URL de tu instancia de CodeAlive (por ejemplo, https://codealive.yourcompany.com)
- Establece CODEALIVE_MCP_ALLOWED_HOSTS en el nombre de host exacto que los clientes usan para este servidor MCP
- Los clientes deben proporcionar su clave de API mediante el encabezado Authorization: Bearer YOUR_KEY

Consulta docker-compose.example.yml para obtener la plantilla de configuración completa.

Por ejemplo, los clientes actuales de Codex y Claude Code pueden usar OAuth del navegador sin almacenar una clave de API de CodeAlive:

codex mcp add codealive --url https://mcp.codealive.ai/api
codex mcp login codealive

claude mcp add --transport http codealive https://mcp.codealive.ai/api
# Start Claude Code and run /mcp to authenticate.

Cursor y OpenCode también descubren OAuth automáticamente desde la misma URL. Usa cursor-agent mcp login codealive o opencode mcp auth codealive cuando su interfaz no lo solicite automáticamente. La configuración con clave de API sigue disponible como opción de compatibilidad.

Perfil de implementación OAuth 2.1

Las implementaciones HTTP remotas pueden habilitar la autorización del navegador mientras mantienen los clientes con clave de API heredados funcionando durante el despliegue. El modo OAuth publica metadatos de recursos protegidos MCP, valida JWTs exactos vinculados al emisor/recurso y los intercambia por un token de API de herramienta separado de corta duración. El token de portador MCP entrante nunca se reenvía aguas abajo.

Variable de entorno	Propósito
`CODEALIVE_MCP_OAUTH_ENABLED=true`	Habilita la validación OAuth y el descubrimiento de autorización MCP para transporte HTTP
`CODEALIVE_OAUTH_ISSUER`	Emisor exacto de OpenIddict, con barra diagonal final
`CODEALIVE_MCP_RESOURCE`	URL pública exacta del recurso MCP; su ruta también es la ruta HTTP de MCP
`CODEALIVE_TOOL_API_RESOURCE`	Audiencia aguas abajo; el valor predeterminado es `urn:codealive:tool-api`
`CODEALIVE_OAUTH_INTERNAL_CLIENT_ID`	Cliente confidencial del servidor de recursos usado solo para intercambio de tokens
`CODEALIVE_OAUTH_INTERNAL_CLIENT_SECRET`	Secreto requerido para ese cliente interno; el inicio falla de forma segura cuando falta
El servidor de autorización y los valores del servicio MCP deben coincidir exactamente. En CodeAlive Web.Server, la configuración correspondiente se encuentra en `McpOAuth` (`Enabled`, `Issuer`, `Resource`, `ToolApiResource`, `InternalClientId` y `InternalClientSecret`). Conserva el anillo de claves de Data Protection de Web.Server y los certificados de firma/cifrado de OpenIddict entre réplicas y reinicios. Para una rotación interna de credenciales sin tiempo de inactividad, asigna a la nueva credencial un nuevo ID de cliente, implementa Web.Server con el par actual y el de `PreviousInternalClientId`/`PreviousInternalClientSecret`, actualiza las réplicas de MCP al nuevo par actual y luego elimina el par anterior. Web.Server falla deliberadamente al iniciar en lugar de cambiar un secreto en un ID de cliente existente.

Habilita las marcas de Web.Server y MCP en la misma implementación; una implementación habilitada a medias no es un estado estable válido. Las credenciales de clave de API conservan su gramática heredada explícita y nunca se utilizan como respaldo cuando falla la validación de OAuth.

Conexión de clientes MCP a tu instancia implementada

Usa los mismos detalles de conexión genéricos que CodeAlive Cloud, reemplazando el endpoint por la URL /api de tu implementación:

Endpoint: https://your-server.example.com/api
Transporte: Streamable HTTP
Encabezado de autenticación: Authorization: Bearer YOUR_API_KEY_HERE

Para conocer el formato de configuración exacto, abre la guía de integración de clientes correspondiente.

🪟 Windows y WSL

Usa la documentación específica del cliente para la configuración de Windows y WSL:

Para servidores autoalojados que se ejecutan en WSL2, los clientes de Windows deben poder acceder al endpoint /api del servidor. Usa redes reflejadas en versiones compatibles de Windows 11 o conéctate a través de la dirección de la VM de WSL2.

🐞 Solución de problemas

Diagnóstico rápido

Prueba el servicio alojado:
```
curl https://mcp.codealive.ai/health
```

Verifica tu clave de API:

curl -H "Authorization: Bearer YOUR_API_KEY" https://app.codealive.ai/api/v1/data_sources

Habilita el registro de depuración: Agrega --debug a los argumentos del servidor local

Problemas comunes

"Conexión rechazada" → Verifica la conexión a internet
"401 No autorizado" → Verifica tu clave de API
"No se encontraron repositorios" → Verifica los permisos de la clave de API en el panel de CodeAlive
Registros específicos del cliente → Consulta la documentación de tu cliente de IA para los registros de MCP

Problemas de Windows / WSL

docker: command not found en WSL → Habilita la integración de WSL de Docker Desktop para tu distribución (Configuración → Recursos → Integración de WSL) o usa la ruta completa /usr/bin/docker
ENOENT o spawn error para npx/python → Los shells de WSL no interactivos no heredan las rutas nvm/pyenv. Usa rutas absolutas en las configuraciones de MCP
Connection refused al servidor autoalojado en WSL2 → WSL2 usa redes NAT; localhost difiere entre Windows y WSL2. Habilita las redes reflejadas en .wslconfig o usa la IP de la VM de WSL2 (hostname -I)
Claude Desktop no puede conectarse al servidor MCP de WSL → Claude Desktop no admite la creación de subprocesos de WSL. Usa HTTP remoto (https://mcp.codealive.ai/api), Docker Desktop o el patrón de proxy wsl.exe (consulta la sección de Windows y WSL)

Cómo obtener ayuda

📧 Correo electrónico: support@codealive.ai
🐛 Problemas: Issues de GitHub

📦 Publicación en el Registro de MCP

Para mantenedores: consulta DEPLOYMENT.md para obtener instrucciones sobre cómo publicar nuevas versiones en el Registro de MCP.

Política de Privacidad

CodeAlive procesa los repositorios y las consultas que envías a través de esta extensión para proporcionar búsqueda semántica y análisis del código base. Para obtener detalles completos sobre la privacidad, consulta la Política de Privacidad de CodeAlive.

📄 Licencia

Licencia MIT: consulta el archivo LICENSE para obtener más detalles.

¿Listo para potenciar tu asistente de IA con un profundo entendimiento del código?
Comienza ahora →