by CodeLogicIncEngineering
Provides impact analysis tools for code and database changes within AI programming assistants, leveraging CodeLogic's software dependency data.
Enables AI assistants to assess the impact of code modifications and database entity changes by querying CodeLogic's rich dependency data.
mcp.json
(or equivalent) file, specifying the command (uvx
or uv
) and required environment variables (CODELOGIC_SERVER_HOST
, CODELOGIC_USERNAME
, CODELOGIC_PASSWORD
, CODELOGIC_WORKSPACE_NAME
, optional CODELOGIC_DEBUG_MODE
).codelogic-mcp-server
.codelogic-method-impact
(method‑level impact) and codelogic-database-impact
(database entity impact).timing_log.txt
, impact_data_*.json
) in a temporary directory.args
field (e.g., codelogic-mcp-server@0.2.2
).uvx
workaround: use uv
instead of uvx
when launching from certain IDEs.uv
/uvx
). No other external dependencies are needed.uvx
fails?
Use the uv
executable in the command
field and adjust the args
accordingly (see the MacOS workaround section).codelogic-mcp-server
(e.g., %TEMP%\codelogic-mcp-server
on Windows, /tmp/codelogic-mcp-server
on macOS/Linux).codelogic-mcp-server@latest
with codelogic-mcp-server@<version>
in the args
array.An MCP Server to utilize Codelogic's rich software dependency data in your AI programming assistant.
The server implements two tools:
The MCP server relies upon Astral UV to run, please install
There is a known issue with uvx
on MacOS where the CodeLogic MCP server may fail to launch in certain IDEs (such as Cursor), resulting in errors like:
See issue #11
Failed to connect client closed
This appears to be a problem with Astral uvx
running on MacOS. The following can be used as a workaround:
mcp.json
to use uv
instead of uvx
. For example:{
"mcpServers": {
"codelogic-mcp-server": {
"type": "stdio",
"command": "<PATH_TO_UV>/uv",
"args": [
"--directory",
"<PATH_TO_THIS_REPO>/codelogic-mcp-server-main",
"run",
"codelogic-mcp-server"
],
"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 workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}
codelogic-mcp-server
.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:
{
"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"
}
}
}
}
Note: On some systems, you may need to use the full path to the uvx executable instead of just "uvx". For example:
/home/user/.local/bin/uvx
on Linux/Mac orC:\Users\username\AppData\Local\astral\uvx.exe
on Windows.
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:
~/Library/Application\ Support/Claude/claude_desktop_config.json
%APPDATA%/Claude/claude_desktop_config.json
~/.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_WORKSPACE_NAME": "<my workspace>"
}
}
}
Note: On some systems, you may need to use the full path to the uvx executable instead of just "uvx". For example:
/home/user/.local/bin/uvx
on Linux/Mac orC:\Users\username\AppData\Local\astral\uvx.exe
on Windows.
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:
"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>"
}
}
}
Note: On some systems, you may need to use the full path to the uvx executable instead of just "uvx". For example:
/home/user/.local/bin/uvx
on Linux/Mac orC:\Users\username\AppData\Local\astral\uvx.exe
on Windows.
After adding the configuration, restart Windsurf IDE or refresh the tools to apply the changes.
To configure the CodeLogic MCP server in Cursor:
.cursor/mcp.json
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_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}
Note: On some systems, you may need to use the full path to the uvx executable instead of just "uvx". For example:
/home/user/.local/bin/uvx
on Linux/Mac orC:\Users\username\AppData\Local\astral\uvx.exe
on Windows.
The CodeLogic MCP server tools will now be available in your Cursor workspace.
To help the AI assistant use the CodeLogic tools effectively, you can add the following instructions/rules to your client's configuration. We recommend customizing these instructions to align with your team's specific coding standards, best practices, and workflow requirements:
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
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
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
To configure CodeLogic rules in Cursor:
# 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
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_WORKSPACE_NAME
: The name of the workspace to use.CODELOGIC_DEBUG_MODE
: Set to true
to enable debug mode. When enabled, additional debug files such as timing_log.txt
and impact_data*.json
will be generated. Defaults to false
."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"
}
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"
],
This MCP server has the following version compatibility requirements:
If you're upgrading, make sure your CodeLogic server meets the minimum API version requirement.
When CODELOGIC_DEBUG_MODE=true
, debug files are written to the system temporary directory:
%TEMP%\codelogic-mcp-server
(typically C:\Users\{username}\AppData\Local\Temp\codelogic-mcp-server
)/tmp/codelogic-mcp-server
(or $TMPDIR/codelogic-mcp-server
if set)/tmp/codelogic-mcp-server
(or $TMPDIR/codelogic-mcp-server
if set)Debug files include:
timing_log.txt
- Performance timing informationimpact_data_*.json
- Raw impact analysis data for troubleshootingFinding your log directory:
import tempfile
import os
print("Log directory:", os.path.join(tempfile.gettempdir(), "codelogic-mcp-server"))
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.
If you want to run integration tests that connect to a real CodeLogic server:
test/.env.test.example
to test/.env.test
and populate with your CodeLogic server detailspython -m unittest discover -s test -p "integration_*.py"
Note: Integration tests require access to a CodeLogic server instance.
Please log in to share your review and rating for this MCP.
Discover more MCP servers with similar functionality and use cases
by zed-industries
Provides real-time collaborative editing powered by Rust, enabling developers to edit code instantly across machines with a responsive, GPU-accelerated UI.
by cline
Provides autonomous coding assistance directly in the IDE, enabling file creation, editing, terminal command execution, browser interactions, and tool extension with user approval at each step.
by continuedev
Provides continuous AI assistance across IDEs, terminals, and CI pipelines, offering agents, chat, inline editing, and autocomplete to accelerate software development.
by github
Enables AI agents, assistants, and chatbots to interact with GitHub via natural‑language commands, providing read‑write access to repositories, issues, pull requests, workflows, security data and team activity.
by block
Automates engineering tasks by installing, executing, editing, and testing code using any large language model, providing end‑to‑end project building, debugging, workflow orchestration, and external API interaction.
by RooCodeInc
An autonomous coding agent that lives inside VS Code, capable of generating, refactoring, debugging code, managing files, running terminal commands, controlling a browser, and adapting its behavior through custom modes and instructions.
by lastmile-ai
A lightweight, composable framework for building AI agents using Model Context Protocol and simple workflow patterns.
by firebase
Provides a command‑line interface to manage, test, and deploy Firebase projects, covering hosting, databases, authentication, cloud functions, extensions, and CI/CD workflows.
by gptme
Empowers large language models to act as personal AI assistants directly inside the terminal, providing capabilities such as code execution, file manipulation, web browsing, vision, and interactive tool usage.