D365 F&O Developer Intelligence Engine

ローカル・オフラインで動作する MCP（Model Context Protocol）サーバー。AI コーディングアシスタント（Cursor、Claude Code、GitHub Copilot）を、実際の Dynamics 365 Finance & Operations AOT メタデータに基づかせることにより、X++ コード生成時にフィールド名、メソッドシグネチャ、Chain of Command（CoC）ラッパーを幻覚的にでっち上げないようにします。

ステータス: 初期ビルド ・Part 1（メタデータ取り込み）を実装中。まだ動作する MCP サーバーではありません。 下記の プロジェクト状況 を参照してください。

問題

D365 F&O は、アプリケーションモデル全体（テーブル、クラス、フォーム、拡張データ型）を XML として PackagesLocalDirectory 配下に保存します。環境あたり 500,000 オブジェクトを超えることもあります。AI コーディングアシスタントはこの XML を見たことがなく、トレーニングから得た一般的な X++ 構文しか知りません。テーブルを拡張したり Chain of Command ラッパーを書くよう依頼すると、環境には存在しないフィールドやメソッドを自信満々に参照してしまいます。これはプロンプトの問題ではありません。AI に欠けているのは命令ではなくデータです。

Related MCP server: Seta MCP

アプローチ

1. 取り込み（このリポジトリ、進行中） — 生の AxTable/AxClass XML を lxml を使って構造化された正しい JSON にパースし、X++ ソースに埋め込まれた Chain of Command パターンを正規表現で抽出します。

2. インデックス化（予定） — パース済みメタデータを SQLite + FTS5 に投入し、ローカルで10ミリ秒未満の検索を実現します。

3. 公開（予定） — stdio を介し、インデックスを AI エージェントに MCP ツール（get_table_schema、find_coc_methods など）として公開します。

4. 高度なモジュール（予定） — パターンベースの X++ ベストプラクティスリンター、そしてモデル間の依存関係グラフを提供します。

現在実際に作られているもの

• schema/table_schema.json — パース済み AxTable メタデータ用の JSON Schema。実在する VendTrans テーブルのエクスポートで検証済み。

• schema/class_schema.json — パース済み AxClass / Chain of Command メタデータ用の JSON Schema。実際の完全なクラスファイルではまだ検証していません（詳細はファイルヘッダー参照）。

• parse_table.py — 動作するパーサー: AxTable XML をスキーマ準拠の JSON に変換します。

• parse_class.py — 正規表現ベースの CoC 抽出ツール。書かれていますが、実際のクラスバイトデータに対してはまだ実行されていません。ここにある各正規表現はすべて未検証と見なしてください。

• validate.py — パーサーの出力を JSON Schema に対して検証します。

プロジェクトの現状

テスト学習の延長として、D365 F&O 開発を学びながら構築している進行中プロジェクトです。率直に述べておくべき事実はいくつあります：

• もっと成熟し、活発に保守されているオープンソースプロジェクトが、すでにより大きい規模でこの問題を解決しています: dynamics365ninja/d365fo-mcp-server（26の MCP ツール、ライブ環境の接続、フォームパターンエンジン、Microsoft の IMetadataProvider による安全なメタデータ書き込み）。このリポジトリは、これを改善するもの、または競合することを一切示しません。

• このプロジェクトは、品質には目を瞑るとして、対象範囲と設計が異なります: Python であること、書き込みを行わず読み取り専用であること、ライブ環境の接続の代わりに静的な AOT XML エクスポートに対して構築されていること、さらに現時点では取り込みレイヤーに限定されていること。

• 正直に言えば、このプロジェクトの価値は、設計上の判断が説明できる程度に問題と解析・インデックス化のアプローチを深く理解することにあり、人と違うことや先駆的であることにはありません。

必要なもの

• Python 3.10+

• lxml

• jsonschema（開発中のスキーマ検証用）

pip install lxml jsonschema

フィクスチャ

これらはフィクスチャで、Microsoft 標準の USMF/DAT デモデータが動くローカルかつオフラインの Hyper-V VM からの AOT XML エクスポート、および第三者や組織の知的財産（IP）を含まない一から構築したカスタムモデルです。fixtures/tables/ と fixtures/classes/ を参照してください。ここには自分のエクスポートを置いてください。それらはこのテンプレートには含まれていません。

ライセンス

MIT