コードロジック

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

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

コンポーネント

ツール

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

codelogic-method-impact : コードに対する CodeLogic サーバーの API から影響評価を取得します。
- 作業中の特定の「メソッド」とそれに関連付けられた「クラス」を受け取ります。
codelogic-database-impact : コードとデータベースエンティティ間の影響を分析します。
- データベースエンティティの種類 (列、テーブル、またはビュー) とその名前を取得します。

インストール

前提条件

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

さまざまなIDEの設定

Visual Studio Code の構成

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

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

あるいは、コマンドパレットから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実行ファイルへのフルパスを使用する必要がある場合があります。例：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 サーバーを構成するには:

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

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

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 ルールを構成するには:

カーソル設定を開く
「ルール」セクションに移動します
「ユーザールール」に次のコンテンツを追加します。

# 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 サーバーに接続する統合テストを実行する場合:

test/.env.test.exampleをtest/.env.testにコピーし、CodeLogic サーバーの詳細を入力します。
統合テストを実行します。

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

注: 統合テストでは、CodeLogic サーバーインスタンスへのアクセスが必要です。

CodeLogic

Integrations