CodeAlive MCP

CodeAlive MCP: Contexto profundo para su proyecto (especialmente para bases de código grandes)

Este servidor MCP (Protocolo de contexto de modelo) para la API de CodeAlive permite que los clientes de IA como Claude Desktop, Cursor, Windserf, VS Code (GitHub Copilot), Cline, Roo-Code y Refact accedan a las funciones avanzadas de interacción de código base y búsqueda de código semántico de CodeAlive.

CodeAlive MCP mejora estos agentes al proporcionar un contexto enriquecido de la base de código de su proyecto, lo que permite interacciones más inteligentes y eficientes.

¿Qué es CodeAlive?

CodeAlive es una plataforma que analiza toda su base de código, incluyendo documentación y dependencias, para comprender su estructura, patrones y lógica. Crea un mapa interno detallado de sus repositorios o espacios de trabajo, lo que permite a cualquier profesional de TI obtener respuestas rápidas, fiables y de alta calidad a sus preguntas sobre su solución.

El uso de este servidor MCP permite a los agentes de IA (como Claude, Copilot, etc.) aprovechar la profunda comprensión del código de CodeAlive. Esto ayuda a los agentes a:

• Encuentre código relevante más rápido: obtenga fragmentos de código precisos relacionados con sus preguntas.
• Comprenda el panorama general: obtenga contexto sobre todo el repositorio o espacio de trabajo, no solo archivos aislados.
• Reducir costos y tiempo: Mejore la eficiencia del agente al proporcionar un contexto preciso de manera directa, lo que reduce la necesidad de realizar búsquedas exhaustivas de archivos o conjeturas.

Tabla de contenido

• Herramientas disponibles
• Empezando
  • Prerrequisitos
  • Obtener una clave API
  • Instalación
• Configuración
  • Variables de entorno
  • Opciones de línea de comandos
• Integración con clientes de IA
  • Continuar
  • Escritorio de Claude
  • Visual Studio Code con GitHub Copilot
  • Cursor
• Usando Python directamente
  • Claude Desktop con Python
  • Cursor con Python
• Solución de problemas
• Licencia

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas:

1. chat_completions : Accede a la API de chat de CodeAlive con el contexto de la base de código. Si tu clave de API está asignada a una sola fuente de datos, especificarla es opcional.
2. get_data_sources : enumera los repositorios y espacios de trabajo disponibles indexados por CodeAlive.
3. search_code : Busca fragmentos de código en tus fuentes de datos mediante la búsqueda semántica de CodeAlive. Si tu clave API está asignada a una sola fuente de datos, especificarla es opcional.

Empezando

Prerrequisitos

• Python 3.11
• uv (recomendado) o pip
• Una cuenta CodeAlive y una clave API

Obtener una clave API

1. Inicie sesión en su cuenta de CodeAlive en https://app.codealive.dev/ .
2. Vaya a la sección Claves API (en Organización).
3. Haga clic en " + Crear clave API ".
4. Asigne a su clave un nombre descriptivo (por ejemplo, "Mi clave MCP local") y seleccione el alcance apropiado (por ejemplo, "Todas las fuentes de datos" o seleccione fuentes específicas).
5. Haga clic en " Crear ".
6. Importante: Copie la clave API generada inmediatamente y guárdela de forma segura. No podrá volver a verla después de cerrar el cuadro de diálogo.

Instalación

Instalación con uv (recomendado)

Instalación con pip

Configuración

Configure el servidor utilizando variables de entorno o argumentos de línea de comandos.

Variables de entorno

Se admiten las siguientes variables de entorno:

• CODEALIVE_API_KEY : Su clave de API de CodeAlive. (Obligatorio a menos que se proporcione mediante --api-key )

Opciones de línea de comandos

• --api-key : Su clave de API de CodeAlive. Anula la variable de entorno CODEALIVE_API_KEY .
• --transport : Tipo de transporte: "stdio" (predeterminado) o "sse" .
• --host : Dirección de host para el transporte SSE (predeterminado: 0.0.0.0 ).
• --port : Puerto para transporte SSE (predeterminado: 8000 ).
• --debug : habilita el modo de depuración con registro detallado en la salida/error estándar.

Integración con clientes de IA

A continuación se muestran ejemplos de configuración para clientes de IA populares. Recuerde reemplazar marcadores como /path/to/your/codealive-mcp y YOUR_API_KEY_HERE con sus valores reales. Generalmente, se recomienda usar variables de entorno (bloque env ) en lugar de introducir la clave API directamente en el archivo de configuración.

Continuar

1. Configure el servidor MCP en .continue/config.yaml de su proyecto o globalmente en ~/.continue/config.yaml :
   # ~/.continue/config.yaml or ./.continue/config.yaml mcpServers: - name: CodeAlive command: /path/to/your/codealive-mcp/.venv/bin/python # Or use 'uv' if preferred (see Cursor example) args: - /path/to/your/codealive-mcp/src/codealive_mcp_server.py - --debug # Optional: Enable debug logging env: CODEALIVE_API_KEY: YOUR_API_KEY_HERE
2. Reiniciar Continuar o recargar la configuración.

Escritorio de Claude

1. Edite su archivo de configuración de Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (normalmente C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json )
2. Agregue la configuración del servidor MCP:
   { "mcpServers": { "codealive": { "command": "/path/to/your/codealive-mcp/.venv/bin/python", "args": [ "/path/to/your/codealive-mcp/src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } }
   (Asegúrese de que esto se fusione correctamente si el archivo ya tiene contenido)
3. Reinicie Claude Desktop por completo.

Visual Studio Code con GitHub Copilot

1. Abra la configuración de VS Code (JSON) usando la paleta de comandos ( Ctrl+Shift+P o Cmd+Shift+P ) y seleccionando "Preferencias: Abrir configuración de usuario (JSON)".
2. Agregue la configuración del servidor MCP a su settings.json :
   { // ... other settings ... "mcp": { "servers": { "codealive": { "command": "uv", "args": [ "--directory", "/path/to/your/codealive-mcp", // Path to the MCP server project root "run", "python", "src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } } // ... other settings ... }
   (Asegúrese de que esto se fusione correctamente con la configuración existente)
3. Reinicia VS Code. Asegúrate de que la extensión GitHub Copilot esté configurada para usar servidores MCP si su versión o configuración lo requieren.

Cursor

1. Abra la configuración del cursor ( Cmd+, o Ctrl+, ).
2. Navegue a la sección "MCP" en el panel izquierdo.
3. Haga clic en "Agregar nuevo servidor MCP global".
4. Ingrese la siguiente configuración JSON, actualizando rutas y clave API:
   { "mcpServers": { "codealive": { "command": "uv", "args": [ "--directory", "/path/to/your/codealive-mcp", // Path to the MCP server project root "run", "python", "src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } }
5. Guardar la configuración.
6. Reinicie el cursor por completo.

Usando Python directamente

Si prefiere no usar uv , puede invocar el script del servidor directamente mediante el intérprete de Python desde su entorno virtual. Actualice el command y args en la configuración del cliente según corresponda.

Claude Desktop con Python

Cursor con Python

Solución de problemas

Si el servidor MCP no funciona correctamente con su cliente AI, siga estos pasos:

1. Habilitar el registro de depuración: Añada el indicador --debug a los args de la configuración de MCP de su cliente. Esto imprimirá registros detallados del servidor MCP en su flujo de salida/error estándar. El destino de este flujo depende de cómo el cliente gestione el proceso de MCP.
2. Comprobar la salida del servidor MCP:
   • Intente ejecutar el comando del servidor directamente en su terminal (primero active el entorno virtual):
     # Activate venv first! export CODEALIVE_API_KEY="YOUR_API_KEY_HERE" python src/codealive_mcp_server.py --debug --transport stdio
   • Busque mensajes de error, especialmente relacionados con la validación de claves API o problemas de conexión.
3. Revisar los registros del cliente: Consulta la documentación o la configuración de tu cliente de IA para encontrar sus archivos de registro. Busca errores relacionados con el inicio o la comunicación con el servidor MCP "codealive".
   • Escritorio de Claude:
     • Verifique los registros de la aplicación principal.
     • Busque registros específicos de MCP:
       • macOS: ~/Library/Logs/Claude/mcp.log y ~/Library/Logs/Claude/mcp-server-codealive.log
       • Windows: %LOCALAPPDATA%\Claude\Logs\mcp.log y %LOCALAPPDATA%\Claude\Logs\mcp-server-codealive.log (la ruta suele ser C:\Users\YourUsername\AppData\Local\Claude\Logs )
   • Cursor:
     • Utilice la paleta de comandos ( Cmd+Shift+P / Ctrl+Shift+P ) -> Developer: Toggle Developer Tools -> pestaña Consola (para errores a nivel de navegador).
     • Revisa el Panel de Salida: Ve a View -> Output (o haz clic en Output en el panel inferior). En el menú desplegable a la derecha del panel de Salida, busca un canal llamado CodeAlive , MCP o relacionado con el proceso del servidor. Este suele contener la salida estándar/derr estándar directa del servidor MCP si --debug está habilitada.
     • Use la paleta de comandos -> Developer: Open Logs Folder . Revise los archivos, especialmente los relacionados con el proceso principal o el host de extensión.
     • Ubicaciones de las carpetas de registro:
       • macOS: ~/Library/Application Support/Cursor/logs/
       • Windows: %APPDATA%\Cursor\logs\ (normalmente C:\Users\YourUsername\AppData\Roaming\Cursor\logs\ )
   • Código VS (Continuar / Copiloto):
     • Utilice la paleta de comandos ( Cmd+Shift+P / Ctrl+Shift+P ) -> Developer: Toggle Developer Tools -> pestaña Consola (para errores a nivel de navegador).
     • Revisa el Panel de Salida: Ve a View -> Output (o haz clic en Output en el panel inferior). En el menú desplegable a la derecha del Panel de Salida, busca un canal llamado CodeAlive , MCP , GitHub Copilot o Continue . Los registros del servidor MCP (especialmente con --debug ) podrían enrutarse aquí.
     • Use la Paleta de Comandos -> Developer: Show Logs... -> Seleccione Extension Host en el menú desplegable. Busque errores relacionados con las extensiones Copilot o Continue que intentan comunicarse mediante MCP.
     • Para registros específicos de Continuar: Use la paleta de comandos -> Continue: Focus on Continue Console View (requiere habilitar Continue: Enable Console en la configuración). Consulte la documentación de solución de problemas de Continuar .
4. Verificar la configuración: Verifique las rutas y valores de command , args y env en el archivo de configuración de MCP de su cliente. Asegúrese de que la sintaxis JSON/YAML sea correcta.
5. Clave API: asegúrese de que su CODEALIVE_API_KEY sea correcta.

Si los problemas persisten, considere abrir un problema en el repositorio del servidor CodeAlive MCP (si está disponible) con registros y detalles de configuración relevantes (enmascarando su clave API).

También puede comunicarse con nuestro equipo de soporte en support@codealive.dev para obtener más ayuda.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.