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

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_MV_NAME": "<my materialized view>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

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.

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_MV_NAME": "<my materialized view>"
    }
  }
}

Después de agregar la configuración, reinicie Claude Desktop para aplicar los cambios.

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_MV_NAME": "<my materialized view>"
    }
  }
}

Después de agregar la configuración, reinicie Windsurf IDE o actualice las herramientas para aplicar los cambios.

Para configurar el servidor CodeLogic MCP en Cursor:

Configure el servidor MCP creando un archivo .cursor/mcp.json :

{
  "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_MV_NAME": "<my materialized view>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

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 del Asistente de IA

Para ayudar al asistente de IA a utilizar las herramientas de CodeLogic de manera eficaz, puede agregar las siguientes instrucciones a la configuración de su cliente:

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

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

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

Cree un archivo .cursor/rules/codelogic-rules.md con el siguiente contenido:

# CodeLogic MCP Server Rules

## 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_MV_NAME : El nombre de la vista materializada 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_MV_NAME": "<my materialized view>",
  "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.

CodeLogic

Integrations