Codelogicincengineering Codelogic MCP Server

🚀 codelogic-mcp-server

このサーバーは、Codelogicの豊富なソフトウェア依存データを活用したMCPサーバーで、AIプログラミングアシスタントに使用できます。

🚀 クイックスタート

codelogic-mcp-serverは、Codelogicのソフトウェア依存データを利用し、AIプログラミングアシスタントに役立つ情報を提供するMCPサーバーです。以下に、サーバーのコンポーネント、インストール方法、テスト方法について説明します。

✨ 主な機能

ツール

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

• get-impact：codelogicサーバーAPIからコードの影響評価を取得します。
  • 与えられた「メソッド」（method）とそれに関連する「クラス」（class）を受け取ります。

📦 インストール

前提条件

MCPサーバーはAstral UVでの実行に依存しています。まず、こちらからインストールしてください。

Claude Desktop

• MacOS：~/Library/Application\ 支持/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、例：https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<ユーザー名>",
      "CODELOGIC_PASSWORD": "<パスワード>",
      "CODELOGIC_MV_NAME": "<マテリアライズドビュー名>"
    }
  }
}

Windsurf IDE

このMCPサーバーを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、例：https://myco.app.codelogic.com>",
      "CODELOGIC_USERNAME": "<ユーザー名>",
      "CODELOGIC_PASSWORD": "<パスワード>",
      "CODELOGIC_MV_NAME": "<マテリアライズドビュー名>"
    }
  }
}

グローバルルールの追加

Windsurfがツールを呼び出すのを支援するための「グローバルルール」を追加します。~/.codeium/windsurf/memories/global_rules.mdMarkdownファイルを作成または変更し、以下の内容を追加します。

既存のコードを変更するよう要求された場合、提供されたコードと変更対象のメソッドまたは関数に対してget-impact MCPツールを実行してください。ツールからの結果で、指定されたメソッドまたは関数の影響を強調表示してください。

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

バージョン固定

MCPサーバーの「最新バージョン」ではなく、特定のバージョンを固定することができます。pypiにある特定のバージョンに対応するように、argsフィールドを変更します。例えば：

    "args": [
      "codelogic-mcp-server@0.2.2"
    ],

💻 使用例

基本的な使用法

このサーバーのツールを使用するには、インストールが完了した後、対応するコマンドを実行します。例えば、get-impactツールを使用する場合は、適切なメソッドとクラスを指定して呼び出します。

📚 ドキュメント

テスト

単体テストの実行

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

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

単体テストではモックデータを使用するため、CodeLogicサーバーに接続する必要はありません。

統合テスト（オプション）

実際のCodeLogicサーバーに接続した統合テストを実行する場合は、以下の手順を行います。

1. requestsパッケージをインストールします。

   pip install requests
   

2. ターミナルで以下のコマンドを実行します。

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

これらのテストは実際のCodeLogicサーバーに接続し、有効な資格情報が必要です。CODELOGIC_SERVER_HOST、CODELOGIC_USERNAME、CODELOGIC_PASSWORD環境変数が設定されていることを確認してください。