Dynamics 365 Table Relationship Explorer CLI and MCP について
Dynamics 365/Axapta のテーブル関係を調べる CLI と MCP サーバーで、開発者や AI アシスタント向けです。関係パスの検索、詳細確認、統計取得に対応します。
主な機能
- 01直接関連するテーブルの検索
- 02中間階層数を指定したパス検索
- 03関係の詳細確認
- 04テーブル一覧と関係統計
- 05関係ファイルの最適化
活用シーン
- 012つのテーブル間の関係パスを追跡
- 02テーブルの関連先や関係を確認
- 03関係ファイルを縮小して処理を効率化
MCP 対応
FastMCP ベースのパッケージがコア機能をツールとして公開し、MCP 対応 AI アシスタントから利用できます。環境変数とコマンドライン引数で設定できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Dynamics 365 テーブル関係エクスプローラー CLI および MCP
https://github.com/ameyer505/MicrosoftDynamicsTableAssociations のデータを使用し、着想を得ています。
このリポジトリには、2 つのパッケージが含まれています。
- コアパッケージ(
d365-relations-cli):テーブル関係の検索機能と CLI が含まれています。 - MCP パッケージ(
d365-relations-mcp):コア機能を AI アシスタントに公開する MCP サーバーを提供します。
コアパッケージ
コアパッケージでは、以下の機能を提供します。
- 直接関連するテーブルの検索(大文字と小文字を区別しません)
- 中間テーブルのレベル数を設定して、テーブル間の関係パスを検索
- 関係の詳細情報を取得
- 利用可能なすべてのテーブルを一覧表示
- 関係に関する統計情報を取得
- 関係ファイルを最適化して、サイズを削減しパフォーマンスを向上
MCP パッケージ
MCP パッケージはコアパッケージを基盤とし、FastMCP を使用してその機能を MCP ツールとして公開します。
- コアパッケージの機能に対応する MCP ツール
- 環境変数とコマンドライン引数による簡単な設定
インストール
どちらのパッケージも個別にインストールできます。
# or using uv
uv add d365-relations-cli
uv add d365-relations-mcpk
使用方法
コアパッケージの CLI
# Find related tables
uv run tr find-related Customer
# Find relationship paths
uv run tr find-relationship Customer SalesOrder --levels 2
# Optimize relationship file
uv run tr optimize -i tablefieldassociations.json -o tablefieldassociations_opt.json
MCP サーバー
# Start the MCP server
uv run mcp
# optionally specify a different relationship file
uv run mcp --relationship-file tablefieldassociations_opt.json
AI アシスタントとの連携
この MCP サーバーは、MCP プロトコルをサポートする AI アシスタントと連携します。プロンプトの例は example_prompts.md ファイルに記載されています。
使用方法の詳細については、d365-relations-mcp パッケージをご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。