CodeLogic
OfficialコードロジックMCPサーバー
AI プログラミング アシスタントで Codelogic の豊富なソフトウェア依存データを活用するためのMCP サーバー。
コンポーネント
ツール
サーバーは 2 つのツールを実装します。
codelogic-method-impact : コードに対する CodeLogic サーバーの API から影響評価を取得します。
作業中の特定の「メソッド」とそれに関連付けられた「クラス」を受け取ります。
codelogic-database-impact : コードとデータベース エンティティ間の影響を分析します。
データベース エンティティの種類 (列、テーブル、またはビュー) とその名前を取得します。
インストール
前提条件
MCPサーバーはAstral UVに依存して動作します。インストールしてください。
Related MCP server: NOMIK
さまざまな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 サーバー インスタンスへのアクセスが必要です。
Available Tools
8 toolscodelogic-database-impactA
Analyze impacts between code and database entities. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:
Use this tool before implementing code or database changes
Search for the relevant database entity
Review the impact analysis to understand which code depends on this database object and vice versa Particularly crucial when AI-suggested modifications are being considered or when modifying SQL code.
Inputs: name (required), entity_type (required), table_or_view.
codelogic-graph-capabilitiesA
Fetch graph API capabilities/manifest from the CodeLogic server (GET). Returns label and relationship metadata when the graph tier is deployed; otherwise explains missing routes. Uses CODELOGIC_WORKSPACE_NAME for MV id unless materialized_view_id is set.
Inputs: materialized_view_id.
codelogic-graph-impactC
Bounded graph impact from seed node ids (curated HTTP API). Optional direction (upstream|downstream|both), depth, scan_space, materialized_view_id.
Inputs: seed_node_ids (required), depth, direction, scan_space, +1 more.
codelogic-graph-ownersB
Look up owners/reviewers for a graph node (curated HTTP API). Provide node_id or identity_prefix.
Inputs: node_id, scan_space, identity_prefix, materialized_view_id.
codelogic-graph-path-explainA
Explain bounded paths between two graph nodes (curated HTTP API). Requires from_node_id, to_node_id; optional max_depth, scan_space, materialized_view_id.
Inputs: to_node_id (required), from_node_id (required), max_depth, scan_space, +1 more.
codelogic-graph-searchB
Search the CodeLogic knowledge graph (curated HTTP API). Provide query or identity_prefix; optional scan_space, materialized_view_id, limit. Requires server route POST .../ai-retrieval/graph/search.
Inputs: q, limit, query, scan_space, +3 more.
codelogic-graph-validate-change-scopeC
Validate whether a proposed change scope is safe given seed graph nodes (curated HTTP API).
Inputs: seed_node_ids (required), proposed_change_summary (required), scan_space, materialized_view_id.
codelogic-method-impactA
Analyze impacts of modifying a specific method within a given class or type. Uses CODELOGIC_WORKSPACE_NAME environment variable to determine the target workspace. Recommended workflow:
Use this tool before implementing code changes
Run the tool against methods or functions that are being modified
Carefully review the impact analysis results to understand potential downstream effects Particularly crucial when AI-suggested modifications are being considered.
Inputs: class (required), method (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The tools are largely distinct: method-impact and database-impact target specific impact scenarios, while the graph-* tools handle search, traversal, path explanation, validation, and ownership lookup. There is minor potential confusion between graph-impact and graph-validate-change-scope since both analyze change effects, but their descriptions clarify different entry points.
All tools share a consistent codelogic- prefix and hyphenated convention, making the family recognizable. However, the second segment mixes styles: some are noun phrases (graph-capabilities, graph-owners) and others are verb-oriented (graph-search, graph-path-explain), so the pattern is not fully uniform.
Eight tools is well-scoped for a CodeLogic analysis server: two domain-specific impact analyzers, one general graph impact/search pair, plus metadata/owners lookups. Each tool covers a distinct capability without redundancy.
The surface covers the core workflows: impact analysis by method, database entity, and generic graph traversal, plus search, path explanation, ownership lookup, and capability discovery. This is a coherent analysis-focused API with lifecycle operations not needed for the domain.
Maintenance
Related MCP Connectors
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Read-only AI coding tools for change verification, release readiness, capacity, and guidance.
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
Change-impact intelligence for tracing dependencies, stale references and required updates.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceTransforms code repositories and development documentation into a queryable Neo4j knowledge graph, enabling AI assistants to perform intelligent code analysis, dependency mapping, impact assessment, and automated documentation generation across 15+ programming languages.7-
- AlicenseNot gradedqualityDmaintenanceAI-native code intelligence graph that builds a persistent knowledge graph of your codebase in Neo4j and exposes it to AI assistants via MCP, enabling contextual code analysis, impact analysis, and dependency tracking.23MIT
- AlicenseAqualityDmaintenanceEnables AI to analyze, query, and manage a graph-based representation of software architecture for impact analysis, dependency tracking, and design.201AGPL 3.0
- AlicenseBqualityDmaintenanceTransforms codebases into structural knowledge graphs for AI agents and developers, providing precise architectural awareness and dependency mapping.1530MIT