コードロジックMCPサーバー
AI プログラミング アシスタントで Codelogic の豊富なソフトウェア依存データを活用するためのMCP サーバー。
コンポーネント
ツール
サーバーは 2 つのツールを実装します。
インストール
前提条件
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.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 サーバーには次のバージョン互換性要件があります。
アップグレードする場合は、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 サーバー インスタンスへのアクセスが必要です。
