Skip to main content
Glama
CodeLogic

CodeLogic

Official

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. В качестве обходного пути можно использовать следующее:

  1. Клонируйте этот проект локально.

  2. Настройте 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"
      }
    }
  }
}
  1. Перезапустить курсор.

  2. Убедитесь, что глобальное правило курсора для CodeLogic установлено.

  3. Откройте вкладку MCP в курсоре и обновите codelogic-mcp-server .

  4. Попросите Cursor внести изменение кода в существующий класс. Теперь сервер MCP должен успешно выполнить анализ воздействия.

Related MCP server: NOMIK

Конфигурация для разных IDE

Конфигурация кода Visual Studio

Чтобы настроить этот MCP-сервер в VS Code:

  1. Сначала убедитесь, что в VS Code включен режим агента GitHub Copilot.

  2. Создайте файл .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.

  1. В качестве альтернативы вы можете запустить команду MCP: Add Server из палитры команд и указать информацию о сервере.

  2. Для управления серверами MCP используйте команду MCP: List Servers из палитры команд.

  3. После настройки инструменты сервера будут доступны в режиме агента Copilot. Вы можете включать и выключать определенные инструменты по мере необходимости, нажимая кнопку «Инструменты» в представлении чата в режиме агента.

  4. Чтобы использовать инструменты 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:

  1. Настройте сервер 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.

  1. Перезапустите курсор, чтобы изменения вступили в силу.

Инструменты сервера 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:

  1. Открыть настройки курсора

  2. Перейдите в раздел «Правила»

  3. Добавьте следующий контент в «Правила пользователя»:

# 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:

  1. Скопируйте test/.env.test.example в test/.env.test и заполните данными вашего сервера CodeLogic.

  2. Запустите интеграционные тесты:

python -m unittest discover -s test -p "integration_*.py"

Примечание: для интеграционных тестов требуется доступ к экземпляру сервера CodeLogic.

Available Tools

8 tools
codelogic-database-impactA

Analyze impacts between code and database entities. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:

  1. Use this tool before implementing code or database changes

  2. Search for the relevant database entity

  3. 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-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:

  1. Use this tool before implementing code changes

  2. Run the tool against methods or functions that are being modified

  3. 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

    B3.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Transforms 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-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.
      23
      MIT