remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Enables Windsurf IDE to leverage Codelogic's software dependency analysis for assessing the impact of code modifications
codelogic-mcp-server
An MCP Server to utilize Codelogic's rich software dependency data in your AI programming assistant.
Components
Tools
The server implements two tools:
- codelogic-method-impact: Pulls an impact assessment from the CodeLogic server's APIs for your code.
- Takes the given "method" that you're working on and its associated "class".
- codelogic-database-impact: Analyzes impacts between code and database entities.
- Takes the database entity type (column, table, or view) and its name.
Install
Pre Requisites
The MCP server relies upon Astral UV to run, please install
To configure this MCP server in VS Code:
- First, ensure you have GitHub Copilot agent mode enabled in VS Code.
- Create a
.vscode/mcp.json
file in your workspace with the following configuration:
- Alternatively, you can run the
MCP: Add Server
command from the Command Palette and provide the server information. - To manage your MCP servers, use the
MCP: List Servers
command from the Command Palette. - Once configured, the server's tools will be available to Copilot agent mode. You can toggle specific tools on/off as needed by clicking the Tools button in the Chat view when in agent mode.
- To use the Codelogic tools in agent mode, you can specifically ask about code impacts or database relationships, and the agent will utilize the appropriate tools.
Configure Claude Desktop by editing the configuration file:
- On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows:
%APPDATA%/Claude/claude_desktop_config.json
- On Linux:
~/.config/Claude/claude_desktop_config.json
Add the following to your configuration file:
After adding the configuration, restart Claude Desktop to apply the changes.
To run this MCP server with Windsurf IDE:
Configure Windsurf IDE:
To configure Windsurf IDE, you need to create or modify the ~/.codeium/windsurf/mcp_config.json
configuration file.
Add the following configuration to your file:
After adding the configuration, restart Windsurf IDE or refresh the tools to apply the changes.
To configure the CodeLogic MCP server in Cursor:
- Configure the MCP server by creating a
.cursor/mcp.json
file:
- Restart Cursor to apply the changes.
The CodeLogic MCP server tools will now be available in your Cursor workspace.
AI Assistant Instructions
To help the AI assistant use the CodeLogic tools effectively, you can add the following instructions to your client's configuration:
Create a .vscode/copilot-instructions.md
file with the following content:
Create a file ~/.claude/instructions.md
with the following content:
Create or modify the ~/.codeium/windsurf/memories/global_rules.md
markdown file with the following content:
Create a .cursor/rules/codelogic-rules.md
file with the following content:
Environment Variables
The following environment variables can be configured to customize the behavior of the server:
CODELOGIC_SERVER_HOST
: The URL of the CodeLogic server.CODELOGIC_USERNAME
: Your CodeLogic username.CODELOGIC_PASSWORD
: Your CodeLogic password.CODELOGIC_MV_NAME
: The name of the materialized view to use.CODELOGIC_DEBUG_MODE
: Set totrue
to enable debug mode. When enabled, additional debug files such astiming_log.txt
andimpact_data*.json
will be generated. Defaults tofalse
.
Example Configuration
Pinning the version
instead of using the latest version of the server, you can pin to a specific version by changing the args field to match the version in pypi e.g.
Version Compatibility
This MCP server has the following version compatibility requirements:
- Version 0.3.1 and below: Compatible with all CodeLogic API versions
- Version 0.4.0 and above: Requires CodeLogic API version 25.10.0 or greater
If you're upgrading, make sure your CodeLogic server meets the minimum API version requirement.
Testing
Running Unit Tests
The project uses unittest for testing. You can run unit tests without any external dependencies:
Unit tests use mock data and don't require a connection to a CodeLogic server.
Integration Tests (Optional)
If you want to run integration tests that connect to a real CodeLogic server:
- Copy
test/.env.test.example
totest/.env.test
and populate with your CodeLogic server details - Run the integration tests:
Note: Integration tests require access to a CodeLogic server instance.
You must be authenticated.
Interact with CodeLogic, a Software Intelligence platform that graphs complex code and data architecture dependencies, to boost AI accuracy and insight.