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
Visual Studio Code Configuration
To configure this MCP server in VS Code:
First, ensure you have GitHub Copilot agent mode enabled in VS Code.
Create a
.vscode/mcp.jsonfile in your workspace with the following configuration:
{
"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"
}
}
}
}
Alternatively, you can run the
MCP: Add Servercommand from the Command Palette and provide the server information.To manage your MCP servers, use the
MCP: List Serverscommand 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.
Claude Desktop Configuration
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:
"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>"
}
}
}
After adding the configuration, restart Claude Desktop to apply the changes.
Windsurf IDE Configuration
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:
"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>"
}
}
}
After adding the configuration, restart Windsurf IDE or refresh the tools to apply the changes.
Cursor Configuration
To configure the CodeLogic MCP server in Cursor:
- Configure the MCP server by creating a
.cursor/mcp.jsonfile:
{
"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"
}
}
}
}
- Restart Cursor to apply the changes.
The CodeLogic MCP server tools will now be available in your Cursor workspace.
AI Assistant Instructions/Rules
To help the AI assistant use the CodeLogic tools effectively, you can add the following instructions/rules to your client’s configuration:
VS Code (GitHub Copilot) Instructions
Create a .vscode/copilot-instructions.md file with the following content:
# 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
Claude Desktop Instructions
Create a file ~/.claude/instructions.md with the following content:
# 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
Windsurf IDE Rules
Create or modify the ~/.codeium/windsurf/memories/global_rules.md markdown file with the following content:
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
Cursor Global Rule
To configure CodeLogic rules in Cursor:
- Open Cursor Settings
- Navigate to the “Rules” section
- Add the following content to “User Rules”:
# CodeLogic MCP Server Rules
Please follow these guidelines when working with CodeLogic tools and making code changes.
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
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 totrueto enable debug mode. When enabled, additional debug files such astiming_log.txtandimpact_data*.jsonwill be generated. Defaults tofalse.
Example Configuration
"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"
}
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.
"args": [
"codelogic-mcp-server@0.2.2"
],
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:
python -m unittest discover -s test -p "unit_*.py"
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.exampletotest/.env.testand populate with your CodeLogic server details - Run the integration tests:
python -m unittest discover -s test -p "integration_*.py"
Note: Integration tests require access to a CodeLogic server instance.
Codelogic MCP Server
Project Details
- CodeLogicIncEngineering/codelogic-mcp-server
- Mozilla Public License 2.0
- Last Updated: 4/21/2025
Categories
Recomended MCP Servers
A beginner-friendly MCP server template featuring a PostgreSQL connector with clean, easy-to-understand code. Perfect for developers new to...
A open-source library enabling AI models to control hardware devices via serial communication using the MCP protocol. Initial...
Efficient implementation of the Google Drive MCP server
Automatable GenAI Scripting
Mcp server to connect with zerodha's kite trade apis
Model Context Protocol (MCP) server for connecting Claude with the Intervals.icu API
BigGo MCP Server utilizes APIs from BigGo, a professional price comparison website.
An MCP (Model Context Protocol) server that provides Ethereum blockchain data tools via Etherscan's API. Features include checking...
just-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini,...
⚡ C̷h̷u̷c̷k̷N̷o̷r̷r̷i̷s̷ MCP server: Helping LLMs break limits. Provides enhancement prompts inspired by elder-plinius' L1B3RT4S
MCP server for interacting with Data.gouv.fr API





