CodeLogic
Officialcodelogic-mcp-сервер
Сервер MCP для использования обширных данных Codelogic о зависимостях программного обеспечения в вашем помощнике по программированию на основе ИИ.
Компоненты
Инструменты
На сервере реализованы два инструмента:
codelogic-method-impact : извлекает оценку воздействия из API сервера CodeLogic для вашего кода.
Принимает заданный «метод», над которым вы работаете, и связанный с ним «класс».
codelogic-database-impact : анализирует влияние между кодом и сущностями базы данных.
Принимает тип сущности базы данных (столбец, таблица или представление) и ее имя.
Установить
Предварительные условия
Для работы сервера MCP требуется Astral UV, установите его.
Обходной путь для uvx в MacOS
Известна проблема с uvx на MacOS , при которой сервер CodeLogic MCP может не запускаться в некоторых IDE (например, Cursor), что приводит к следующим ошибкам: См. проблему № 11
Failed to connect client closedПохоже, это проблема с Astral uvx , работающим на MacOS. В качестве обходного пути можно использовать следующее:
Клонируйте этот проект локально.
Настройте
mcp.jsonдля использованияuvвместоuvx. Например:
{
"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 в курсоре и обновите
codelogic-mcp-server.Попросите Cursor внести изменение кода в существующий класс. Теперь сервер MCP должен успешно выполнить анализ воздействия.
Related MCP server: NOMIK
Конфигурация для разных IDE
Конфигурация кода Visual Studio
Чтобы настроить этот MCP-сервер в VS Code:
Сначала убедитесь, что в VS Code включен режим агента GitHub Copilot.
Создайте файл
.vscode/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_WORKSPACE_NAME": "<my workspace>",
"CODELOGIC_DEBUG_MODE": "true"
}
}
}
}Примечание: В некоторых системах вам может потребоваться использовать полный путь к исполняемому файлу uvx вместо просто "uvx". Например:
/home/user/.local/bin/uvxна Linux/Mac илиC:\Users\username\AppData\Local\astral\uvx.exeна Windows.
В качестве альтернативы вы можете запустить команду
MCP: Add Serverиз палитры команд и указать информацию о сервере.Для управления серверами MCP используйте команду
MCP: List Serversиз палитры команд.После настройки инструменты сервера будут доступны в режиме агента Copilot. Вы можете включать и выключать определенные инструменты по мере необходимости, нажимая кнопку «Инструменты» в представлении чата в режиме агента.
Чтобы использовать инструменты Codelogic в режиме агента, вы можете специально задать вопрос о влиянии кода или связях с базой данных, и агент будет использовать соответствующие инструменты.
Конфигурация рабочего стола Клода
Настройте Claude Desktop, отредактировав файл конфигурации:
В MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonВ Windows:
%APPDATA%/Claude/claude_desktop_config.jsonВ Linux:
~/.config/Claude/claude_desktop_config.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>"
}
}
}Примечание: В некоторых системах вам может потребоваться использовать полный путь к исполняемому файлу uvx вместо просто "uvx". Например:
/home/user/.local/bin/uvxна Linux/Mac илиC:\Users\username\AppData\Local\astral\uvx.exeна Windows.
После добавления конфигурации перезапустите Claude Desktop, чтобы изменения вступили в силу.
Конфигурация Windsurf IDE
Чтобы запустить этот сервер MCP с помощью Windsurf IDE :
Настройте Windsurf IDE :
Чтобы настроить Windsurf IDE, вам необходимо создать или изменить файл конфигурации ~/.codeium/windsurf/mcp_config.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>"
}
}
}Примечание: В некоторых системах вам может потребоваться использовать полный путь к исполняемому файлу uvx вместо просто "uvx". Например:
/home/user/.local/bin/uvxна Linux/Mac илиC:\Users\username\AppData\Local\astral\uvx.exeна Windows.
После добавления конфигурации перезапустите Windsurf IDE или обновите инструменты, чтобы применить изменения.
Конфигурация курсора
Чтобы настроить сервер CodeLogic MCP в Cursor:
Настройте сервер MCP, создав файл
.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"
}
}
}
}Примечание: В некоторых системах вам может потребоваться использовать полный путь к исполняемому файлу uvx вместо просто "uvx". Например:
/home/user/.local/bin/uvxна Linux/Mac илиC:\Users\username\AppData\Local\astral\uvx.exeна Windows.
Перезапустите курсор, чтобы изменения вступили в силу.
Инструменты сервера CodeLogic MCP теперь будут доступны в вашем рабочем пространстве Cursor.
Инструкции/правила помощника ИИ
Чтобы помочь помощнику ИИ эффективно использовать инструменты CodeLogic, вы можете добавить следующие инструкции/правила в конфигурацию вашего клиента. Мы рекомендуем настроить эти инструкции в соответствии с конкретными стандартами кодирования вашей команды, передовыми методами и требованиями к рабочему процессу:
Инструкции по использованию VS Code (GitHub Copilot)
Создайте файл .vscode/copilot-instructions.md со следующим содержимым:
# 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/instructions.md со следующим содержимым:
# 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
Создайте или измените файл разметки ~/.codeium/windsurf/memories/global_rules.md со следующим содержимым:
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Глобальное правило курсора
Чтобы настроить правила CodeLogic в 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Переменные среды
Для настройки поведения сервера можно настроить следующие переменные среды:
CODELOGIC_SERVER_HOST: URL-адрес сервера CodeLogic.CODELOGIC_USERNAME: Ваше имя пользователя CodeLogic.CODELOGIC_PASSWORD: Ваш пароль CodeLogic.CODELOGIC_WORKSPACE_NAME: Имя используемого рабочего пространства.CODELOGIC_DEBUG_MODE: Установите значениеtrue, чтобы включить режим отладки. При включении будут созданы дополнительные файлы отладки, такие какtiming_log.txtиimpact_data*.json. По умолчанию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"
}Закрепление версии
вместо использования последней версии сервера вы можете привязаться к определенной версии, изменив поле args так, чтобы оно соответствовало версии в pypi, например
"args": [
"codelogic-mcp-server@0.2.2"
],Совместимость версий
Данный сервер MCP имеет следующие требования к совместимости версий:
Версия 0.3.1 и ниже: Совместимо со всеми версиями API CodeLogic
Версия 0.4.0 и выше: требуется CodeLogic API версии 25.10.0 или выше.
Если вы выполняете обновление, убедитесь, что ваш сервер CodeLogic соответствует минимальным требованиям к версии API.
Тестирование
Выполнение модульных тестов
Проект использует unittest для тестирования. Вы можете запускать unit-тесты без каких-либо внешних зависимостей:
python -m unittest discover -s test -p "unit_*.py"Модульные тесты используют фиктивные данные и не требуют подключения к серверу CodeLogic.
Интеграционные тесты (необязательно)
Если вы хотите запустить интеграционные тесты, подключающиеся к реальному серверу CodeLogic:
Скопируйте
test/.env.test.exampleвtest/.env.testи заполните данными вашего сервера CodeLogic.Запустите интеграционные тесты:
python -m unittest discover -s test -p "integration_*.py"Примечание: для интеграционных тестов требуется доступ к экземпляру сервера CodeLogic.
Available Tools
8 toolscodelogic-database-impactA
Analyze impacts between code and database entities. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:
Use this tool before implementing code or database changes
Search for the relevant database entity
Review the impact analysis to understand which code depends on this database object and vice versa Particularly crucial when AI-suggested modifications are being considered or when modifying SQL code.
Inputs: name (required), entity_type (required), table_or_view.
codelogic-graph-capabilitiesA
Fetch graph API capabilities/manifest from the CodeLogic server (GET). Returns label and relationship metadata when the graph tier is deployed; otherwise explains missing routes. Uses CODELOGIC_WORKSPACE_NAME for MV id unless materialized_view_id is set.
Inputs: materialized_view_id.
codelogic-graph-impactC
Bounded graph impact from seed node ids (curated HTTP API). Optional direction (upstream|downstream|both), depth, scan_space, materialized_view_id.
Inputs: seed_node_ids (required), depth, direction, scan_space, +1 more.
codelogic-graph-ownersB
Look up owners/reviewers for a graph node (curated HTTP API). Provide node_id or identity_prefix.
Inputs: node_id, scan_space, identity_prefix, materialized_view_id.
codelogic-graph-path-explainA
Explain bounded paths between two graph nodes (curated HTTP API). Requires from_node_id, to_node_id; optional max_depth, scan_space, materialized_view_id.
Inputs: to_node_id (required), from_node_id (required), max_depth, scan_space, +1 more.
codelogic-graph-searchB
Search the CodeLogic knowledge graph (curated HTTP API). Provide query or identity_prefix; optional scan_space, materialized_view_id, limit. Requires server route POST .../ai-retrieval/graph/search.
Inputs: q, limit, query, scan_space, +3 more.
codelogic-graph-validate-change-scopeC
Validate whether a proposed change scope is safe given seed graph nodes (curated HTTP API).
Inputs: seed_node_ids (required), proposed_change_summary (required), scan_space, materialized_view_id.
codelogic-method-impactA
Analyze impacts of modifying a specific method within a given class or type. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:
Use this tool before implementing code changes
Run the tool against methods or functions that are being modified
Carefully review the impact analysis results to understand potential downstream effects Particularly crucial when AI-suggested modifications are being considered.
Inputs: class (required), method (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The tools are largely distinct: method-impact and database-impact target specific impact scenarios, while the graph-* tools handle search, traversal, path explanation, validation, and ownership lookup. There is minor potential confusion between graph-impact and graph-validate-change-scope since both analyze change effects, but their descriptions clarify different entry points.
All tools share a consistent codelogic- prefix and hyphenated convention, making the family recognizable. However, the second segment mixes styles: some are noun phrases (graph-capabilities, graph-owners) and others are verb-oriented (graph-search, graph-path-explain), so the pattern is not fully uniform.
Eight tools is well-scoped for a CodeLogic analysis server: two domain-specific impact analyzers, one general graph impact/search pair, plus metadata/owners lookups. Each tool covers a distinct capability without redundancy.
The surface covers the core workflows: impact analysis by method, database entity, and generic graph traversal, plus search, path explanation, ownership lookup, and capability discovery. This is a coherent analysis-focused API with lifecycle operations not needed for the domain.
Maintenance
Related MCP Connectors
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Read-only AI coding tools for change verification, release readiness, capacity, and guidance.
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
Change-impact intelligence for tracing dependencies, stale references and required updates.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceTransforms code repositories and development documentation into a queryable Neo4j knowledge graph, enabling AI assistants to perform intelligent code analysis, dependency mapping, impact assessment, and automated documentation generation across 15+ programming languages.7-
- AlicenseNot gradedqualityDmaintenanceAI-native code intelligence graph that builds a persistent knowledge graph of your codebase in Neo4j and exposes it to AI assistants via MCP, enabling contextual code analysis, impact analysis, and dependency tracking.23MIT
- AlicenseAqualityDmaintenanceEnables AI to analyze, query, and manage a graph-based representation of software architecture for impact analysis, dependency tracking, and design.201AGPL 3.0
- AlicenseBqualityDmaintenanceTransforms codebases into structural knowledge graphs for AI agents and developers, providing precise architectural awareness and dependency mapping.1530MIT