servidor codelogic-mcp
Un servidor MCP para utilizar los ricos datos de dependencia de software de Codelogic en su asistente de programación de IA.
Componentes
Herramientas
El servidor implementa dos herramientas:
- codelogic-method-impact : extrae una evaluación de impacto de las API del servidor CodeLogic para su código.
- Toma el "método" dado en el que estás trabajando y su "clase" asociada.
- codelogic-database-impact : analiza los impactos entre el código y las entidades de la base de datos.
- Toma el tipo de entidad de la base de datos (columna, tabla o vista) y su nombre.
Instalar
Prerrequisitos
El servidor MCP depende de Astral UV para funcionar, instálelo
Configuración para diferentes IDE
Configuración de Visual Studio Code
Para configurar este servidor MCP en VS Code:
- Primero, asegúrese de tener habilitado el modo de agente GitHub Copilot en VS Code.
- Cree un archivo
.vscode/mcp.json en su espacio de trabajo con la siguiente configuración:
{
"servers": {
"codelogic-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}
Nota: En algunos sistemas, es posible que deba usar la ruta completa del ejecutable uvx en lugar de solo "uvx". Por ejemplo: /home/user/.local/bin/uvx en Linux/Mac o C:\Users\username\AppData\Local\astral\uvx.exe en Windows.
- Alternativamente, puede ejecutar el comando
MCP: Add Server desde la Paleta de comandos y proporcionar la información del servidor. - Para administrar sus servidores MCP, utilice el comando
MCP: List Servers de la Paleta de comandos. - Una vez configurado, las herramientas del servidor estarán disponibles en el modo agente de Copilot. Puede activar o desactivar herramientas específicas según sea necesario haciendo clic en el botón Herramientas en la vista de chat en el modo agente.
- Para utilizar las herramientas de Codelogic en modo agente, puede preguntar específicamente sobre los impactos del código o las relaciones de la base de datos, y el agente utilizará las herramientas adecuadas.
Configuración del escritorio de Claude
Configure Claude Desktop editando el archivo de configuración:
- En MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - En Windows:
%APPDATA%/Claude/claude_desktop_config.json - En Linux:
~/.config/Claude/claude_desktop_config.json
Agregue lo siguiente a su archivo de configuración:
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>"
}
}
}
Nota: En algunos sistemas, es posible que deba usar la ruta completa del ejecutable uvx en lugar de solo "uvx". Por ejemplo: /home/user/.local/bin/uvx en Linux/Mac o C:\Users\username\AppData\Local\astral\uvx.exe en Windows.
Después de agregar la configuración, reinicie Claude Desktop para aplicar los cambios.
Configuración de Windsurf IDE
Para ejecutar este servidor MCP con Windsurf IDE :
Configurar Windsurf IDE :
Para configurar Windsurf IDE, debe crear o modificar el archivo de configuración ~/.codeium/windsurf/mcp_config.json .
Agregue la siguiente configuración a su archivo:
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>"
}
}
}
Nota: En algunos sistemas, es posible que deba usar la ruta completa del ejecutable uvx en lugar de solo "uvx". Por ejemplo: /home/user/.local/bin/uvx en Linux/Mac o C:\Users\username\AppData\Local\astral\uvx.exe en Windows.
Después de agregar la configuración, reinicie Windsurf IDE o actualice las herramientas para aplicar los cambios.
Configuración del cursor
Para configurar el servidor CodeLogic MCP en Cursor:
- Configure el servidor MCP creando un archivo
.cursor/mcp.json :
{
"mcpServers": {
"codelogic-mcp-server": {
"command": "uvx",
"args": [
"codelogic-mcp-server@latest"
],
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}
Nota: En algunos sistemas, es posible que deba usar la ruta completa del ejecutable uvx en lugar de solo "uvx". Por ejemplo: /home/user/.local/bin/uvx en Linux/Mac o C:\Users\username\AppData\Local\astral\uvx.exe en Windows.
- Reinicie el cursor para aplicar los cambios.
Las herramientas del servidor CodeLogic MCP ahora estarán disponibles en su espacio de trabajo del Cursor.
Instrucciones/Reglas del Asistente de IA
Para ayudar al asistente de IA a usar las herramientas de CodeLogic eficazmente, puede agregar las siguientes instrucciones/reglas a la configuración de su cliente. Recomendamos personalizar estas instrucciones para que se ajusten a los estándares de codificación, las mejores prácticas y los requisitos de flujo de trabajo específicos de su equipo:
Instrucciones de VS Code (GitHub Copilot)
Cree un archivo .vscode/copilot-instructions.md con el siguiente contenido:
# CodeLogic MCP Server Instructions
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
Instrucciones de escritorio de Claude
Crea un archivo ~/.claude/instructions.md con el siguiente contenido:
# CodeLogic MCP Server Instructions
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
Reglas de Windsurf IDE
Cree o modifique el archivo markdown ~/.codeium/windsurf/memories/global_rules.md con el siguiente contenido:
When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
Regla global del cursor
Para configurar las reglas de CodeLogic en Cursor:
- Abrir configuración del cursor
- Vaya a la sección "Reglas"
- Añade el siguiente contenido a "Reglas de usuario":
# CodeLogic MCP Server Rules
## Codebase
- The CodeLogic MCP Server is for java, javascript, typescript, and C# dotnet codebases
- don't run the tools on python or other non supported codebases
## AI Assistant Behavior
- When modifying existing code methods:
- Use codelogic-method-impact to analyze code changes
- Use codelogic-database-impact for database modifications
- Highlight impact results for the modified methods
- When modifying SQL code or database entities:
- Always use codelogic-database-impact to analyze potential impacts
- Highlight impact results for the modified database entities
- To use the CodeLogic tools effectively:
- For code impacts: Ask about specific methods or functions
- For database relationships: Ask about tables, views, or columns
- Review the impact results before making changes
- Consider both direct and indirect impacts
Variables de entorno
Las siguientes variables de entorno se pueden configurar para personalizar el comportamiento del servidor:
CODELOGIC_SERVER_HOST : La URL del servidor CodeLogic.CODELOGIC_USERNAME : Su nombre de usuario de CodeLogic.CODELOGIC_PASSWORD : Su contraseña de CodeLogic.CODELOGIC_WORKSPACE_NAME : El nombre del espacio de trabajo a utilizar.CODELOGIC_DEBUG_MODE : Establézcalo en true para habilitar el modo de depuración. Al habilitarlo, se generarán archivos de depuración adicionales, como timing_log.txt e impact_data*.json . El valor predeterminado es false .
Ejemplo de configuración
"env": {
"CODELOGIC_SERVER_HOST": "<url to the server e.g. https://myco.app.codelogic.com>",
"CODELOGIC_USERNAME": "<my username>",
"CODELOGIC_PASSWORD": "<my password>",
"CODELOGIC_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
Fijando la versión
En lugar de usar la última versión del servidor, puede fijar una versión específica cambiando el campo args para que coincida con la versión en pypi , por ejemplo:
"args": [
"codelogic-mcp-server@0.2.2"
],
Compatibilidad de versiones
Este servidor MCP tiene los siguientes requisitos de compatibilidad de versiones:
- Versión 0.3.1 y anteriores: compatible con todas las versiones de API de CodeLogic
- Versión 0.4.0 y superior: Requiere la versión 25.10.0 o superior de la API de CodeLogic
Si está actualizando, asegúrese de que su servidor CodeLogic cumpla con el requisito mínimo de versión de API.
Pruebas
Ejecución de pruebas unitarias
El proyecto utiliza unittest para realizar pruebas. Puedes ejecutar pruebas unitarias sin dependencias externas:
python -m unittest discover -s test -p "unit_*.py"
Las pruebas unitarias utilizan datos simulados y no requieren una conexión a un servidor CodeLogic.
Pruebas de integración (opcional)
Si desea ejecutar pruebas de integración que se conecten a un servidor CodeLogic real:
- Copie
test/.env.test.example en test/.env.test y complételo con los detalles de su servidor CodeLogic - Ejecute las pruebas de integración:
python -m unittest discover -s test -p "integration_*.py"
Nota: Las pruebas de integración requieren acceso a una instancia de servidor CodeLogic.