Skip to main content
Glama
CodeLogic

CodeLogic

Official

コードロジックMCPサーバー

AI プログラミング アシスタントで Codelogic の豊富なソフトウェア依存データを活用するためのMCP サーバー。

コンポーネント

ツール

サーバーは 2 つのツールを実装します。

  • codelogic-method-impact : コードに対する CodeLogic サーバーの API から影響評価を取得します。

    • 作業中の特定の「メソッド」とそれに関連付けられた「クラス」を受け取ります。

  • codelogic-database-impact : コードとデータベース エンティティ間の影響を分析します。

    • データベース エンティティの種類 (列、テーブル、またはビュー) とその名前を取得します。

インストール

前提条件

MCPサーバーはAstral UVに依存して動作します。インストールしてください。

Related MCP server: NOMIK

さまざまなIDEの設定

Visual Studio Code の構成

VS Code でこの MCP サーバーを構成するには:

  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実行ファイルへのフルパスを使用する必要がある場合があります。例:Linux/Macの場合は/home/user/.local/bin/uvxの場合はC:\Users\username\AppData\Local\astral\uvx.exe 。

  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実行ファイルへのフルパスを使用する必要がある場合があります。例:Linux/Macの場合は/home/user/.local/bin/uvxの場合はC:\Users\username\AppData\Local\astral\uvx.exe 。

設定を追加したら、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実行ファイルへのフルパスを使用する必要がある場合があります。例:Linux/Macの場合は/home/user/.local/bin/uvxの場合はC:\Users\username\AppData\Local\astral\uvx.exe 。

設定を追加した後、Windsurf IDE を再起動するか、ツールを更新して変更を適用します。

カーソルの設定

Cursor で CodeLogic MCP サーバーを構成するには:

  1. .cursor/mcp.jsonファイルを作成して MCP サーバーを構成します。

{
  "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実行ファイルへのフルパスを使用する必要がある場合があります。例:Linux/Macの場合は/home/user/.local/bin/uvxの場合はC:\Users\username\AppData\Local\astral\uvx.exe 。

  1. 変更を適用するにはカーソルを再起動します。

CodeLogic MCP サーバー ツールがカーソル ワークスペースで使用できるようになります。

AIアシスタントの指示/ルール

AIアシスタントが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

カーソルグローバルルール

Cursor で CodeLogic ルールを構成するには:

  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 : CodeLogic サーバーの URL。

  • 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 以下: すべての CodeLogic API バージョンと互換性があります

  • バージョン 0.4.0 以上: CodeLogic API バージョン 25.10.0 以上が必要です

アップグレードする場合は、CodeLogic サーバーが最小 API バージョン要件を満たしていることを確認してください。

テスト

ユニットテストの実行

このプロジェクトではテストにunittestを使用しています。外部依存なしでユニットテストを実行できます。

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