Codelogic MCP Server

🚀 codelogic-mcp-server

Codelogicの豊富なソフトウェア依存データを利用したMCPサーバーで、AIプログラミングアシスタントの機能を強化します。

✨ 主な機能

ツール

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

• codelogic-method-impact：CodelogicサーバーのAPIからコードの影響評価を取得します。
  • 処理対象の「メソッド」とそれに関連する「クラス」を入力します。
• codelogic-database-impact：コードとデータベースエンティティ間の関係を分析します。
  • 分析対象のデータベースエンティティのタイプ（列、テーブル、またはビュー）とその名前を入力します。

📦 インストール

前提条件

このMCPサーバーはAstral UV上で動作するため、まずAstral UVをインストールしてください。

{
  "servers": {
    "codelogic-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "codelogic-mcp-server@latest"
      ],
      "env": {
        "CODELOGIC_SERVER_HOST": "<サーバーURL、例：https://myco.app.codelogic.com>",
        "CODELOGIC_USERNAME": "<ユーザー名>",
        "CODELOGIC_PASSWORD": "<パスワード>",
        "CODELOGIC_MV_NAME": "<マテリアライズドビュー>",
        "CODELOGIC_DEBUG_MODE": "true"
      }
    }
  }
}

環境変数

以下の環境変数を使用して、サーバーの動作をカスタマイズできます。

• CODELOGIC_SERVER_HOST：CodelogicサーバーのURL。
• CODELOGIC_USERNAME：Codelogicのユーザー名。
• CODELOGIC_PASSWORD：Codelogicのパスワード。
• CODELOGIC_MV_NAME：使用するマテリアライズドビューの名前。
• CODELOGIC_DEBUG_MODE：デバッグモードを有効にするには「true」に設定します。有効にすると、timing_log.txtやimpact_data*.jsonなどの追加のデバッグファイルが生成されます。デフォルト値は「false」です。

設定例

"env": {
  "CODELOGIC_SERVER_HOST": "<サーバーURL、例：https://myco.app.codelogic.com>",
  "CODELOGIC_USERNAME": "<ユーザー名>",
  "CODELOGIC_PASSWORD": "<パスワード>",
  "CODELOGIC_MV_NAME": "<マテリアライズドビュー>",
  "CODELOGIC_DEBUG_MODE": "true"
}

バージョン固定

最新バージョンのサーバーを使用する代わりに、argsフィールドを変更して特定のバージョンを指定することもできます。例えば：

    "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サーバーインスタンスへのアクセスが必要です。