codelogic-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 должен успешно выполнить анализ воздействия.
Конфигурация для разных 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.