コードロジックMCPサーバー
AI プログラミング アシスタントで Codelogic の豊富なソフトウェア依存データを活用するためのMCP サーバー。
コンポーネント
ツール
サーバーは 2 つのツールを実装します。
codelogic-method-impact : コードに対する CodeLogic サーバーの API から影響評価を取得します。
作業中の特定の「メソッド」とそれに関連付けられた「クラス」を受け取ります。
codelogic-database-impact : コードとデータベース エンティティ間の影響を分析します。
データベース エンティティの種類 (列、テーブル、またはビュー) とその名前を取得します。
インストール
前提条件
MCPサーバーはAstral UVに依存して動作します。インストールしてください。
Related MCP server: DependencyMCP Server
さまざまな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.jsonWindows の場合:
%APPDATA%/Claude/claude_desktop_config.jsonLinuxの場合:
~/.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 impactsWindsurf 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 サーバー インスタンスへのアクセスが必要です。