Fo Semantic MCP

🚀 FO Semantic MCP Server

🚀 Microsoft Dynamics 365 Finance & Operations開発用のモデルコンテキストプロトコルサーバー

深いF&Oの知識を備えたAIコーディングアシスタントを強化します。このMCPサーバーにより、Cursor IDE、Claude Desktop、VS CodeのAIエージェントが50,000以上のF&Oアーティファクトを検索し、ローカルソースコードを読み取り、開発タスクに関連する例を見つけることができます。

🤖 提供する機能: F&O拡張機能を構築する際、AIアシスタントは以下のことができます。

• 自然言語クエリを使用してF&Oアーティファクトを検索する
• 標準のD365コード内で類似の実装とパターンを見つける
• ローカルのF&Oインストールから実際のXMLソースファイルを読み取る
• テーブル、フォーム、クラスなどに関する豊富なメタデータにアクセスする

✨ 主な機能

✅ セマンティック検索 - 自然言語を使用してF&Oアーティファクトを検索する ✅ 50,000以上のアーティファクト - テーブル、フォーム、クラス、EDT、列挙型、データエンティティ、ビュー、クエリ ✅ AIによる説明 - XMLを読まずにアーティファクトの目的を理解する ✅ ローカルファイルアクセス - 完全な分析のために実際のF&O XMLファイルを読み取る ✅ 豊富なメタデータ - ビジネスドメイン、モジュール、構成キー、使用コンテキスト ✅ マルチプラットフォーム対応 - Node.jsを使用してWindows、macOS、Linuxで動作する ✅ MCP互換 - Cursor IDE、Claude Desktop、VS Codeで動作する

🎯 対象ユーザー

• 拡張機能やカスタマイズを構築するF&O開発者
• 既存の実装を学ぶコンサルタント
• システムパターンを理解するアーキテクト
• 開発サイクルを加速するチーム

🔧 含まれる機能

MCPツール: search_FO_artifacts

Microsoft D365 F&Oの標準アーティファクトをセマンティックに検索します。以下を含むアーティファクトのメタデータを返します。

• アーティファクトの名前、タイプ、モジュール
• AIによって生成された説明と使用コンテキスト
• ビジネスドメインの分類
• （設定されている場合）ローカルファイルのパス

MCPプロンプト: fo-development-assistant (Claude Desktopのみ)

F&Oのカスタマイズに関する完全な6ステップの開発ワークフローです。

1. 標準のD365アーティファクトを検索する
2. 標準の実装を読み取る
3. ワークスペース内のカスタムコードを検索する
4. カスタマイズを読み取る
5. コンテキストを考慮したソリューションを生成する
6. 包括的な分析を提示する

注意: このプロンプトワークフローはユーザーが起動し、Claude Desktopで動作します。Cursor IDEでは、手動で同様の手順をAIに指示することができます。

🚀 クイックスタート

1. 前提条件

Node.jsがインストールされていることを確認してください。

• ダウンロード先: https://nodejs.org/
• 最小バージョン: Node.js 18+

2. APIキーの取得

https://www.xplusplus.ai/ からAPIキーを取得してください。 利用可能なプランと価格を確認するには、当社のWebサイトを訪問してください。

3. インストール

最適なインストール方法を選択してください。

オプションA: npxを使用する (推奨 - 常に最新バージョン)

インストールは必要ありません！MCPクライアントを起動すると、自動的に最新バージョンが取得されます。

Cursor IDE (~/.cursor/mcp.json または %USERPROFILE%\.cursor\mcp.json):

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "npx",
      "args": ["-y", "fo-semantic-mcp"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

Claude Desktop (Windowsの場合 ~/AppData/Roaming/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "npx",
      "args": ["-y", "fo-semantic-mcp"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

VS Code (上記のCursor IDEの設定と同様)

npxの利点:

• ✅ インストール不要
• ✅ 常に最新バージョンを自動的に使用
• ✅ 手動での更新不要
• ✅ Windows、macOS、Linuxで動作

macOS/Linuxユーザー: パスにはスラッシュを使用してください。

{
  "env": {
    "FOINDEX_API_KEY": "your_api_key_here",
    "FO_LOCAL_ASSETS_PATH": "/Users/yourname/.local/Microsoft/Dynamics365/10.0.xxxx/PackagesLocalDirectory"
  }
}

オプションB: グローバルインストール

パッケージをシステム全体にグローバルにインストールします。

npm install -g fo-semantic-mcp

次に、MCPクライアントを設定します。

Cursor IDE / Claude Desktop / VS Code:

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "fo-semantic-mcp",
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

グローバルインストールを使用する場合:

• 特定のバージョンを固定したい場合
• インターネット接続が制限されている場合
• 明示的なバージョン管理を好む場合

更新するには:

npm update -g fo-semantic-mcp

オプションC: GitHubリリースからの手動インストール

ローカルディレクトリからダウンロードして実行します。

1. GitHubから最新リリースをダウンロードします。
2. 好みの場所に抽出します (例: C:\tools\fo-semantic-mcp)。
3. 抽出したフォルダで npm install を実行します。 次に、完全なパスを使用して設定します。

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "node",
      "args": ["C:\\tools\\fo-semantic-mcp\\dist\\server.js"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

macOS/Linuxのパスはスラッシュを使用します: /path/to/fo-semantic-mcp/dist/server.js

手動インストールを使用する場合:

• インストール場所を完全に制御したい場合
• サーバーを開発またはカスタマイズしている場合
• 環境がnpmパッケージの実行を制限している場合

4. AIクライアントの再起動

Cursor IDE、Claude Desktop、またはVS Codeを完全に再起動して、MCPサーバーを読み込みます。

🔧 設定オプション

環境変数

PackagesLocalDirectoryの検索

FO_LOCAL_ASSETS_PATH を使用すると、実際のF&O XMLソースファイルを読み取ることができます。これはオプションですが、完全な分析機能を利用するために強く推奨されます。

Windows:

C:\Users\[YourName]\AppData\Local\Microsoft\Dynamics365\[version]\PackagesLocalDirectory

PowerShellコマンドで検索する:

Get-ChildItem "$env:LOCALAPPDATA\Microsoft\Dynamics365\" -Recurse -Filter "PackagesLocalDirectory" | Select-Object FullName

macOS/Linux: F&Oの開発環境によって異なります。一般的な場所は以下の通りです。

~/.local/Microsoft/Dynamics365/[version]/PackagesLocalDirectory
~/Library/Application Support/Microsoft/Dynamics365/[version]/PackagesLocalDirectory

注意: FO_LOCAL_ASSETS_PATH が設定されていない場合、サーバーはセマンティック検索には引き続き機能しますが、ローカルのXMLファイルを読み取ることはできません。

💻 使用例

基本的な検索

"Find customer tables in D365"
"Show me sales order forms"
"Search for pricing calculation classes"
"Find inventory transaction data entities"

アーティファクトタイプのフィルター

より絞り込んだ結果を得るために、アーティファクトタイプでフィルターをかけることができます。

• テーブル
• フォーム
• クラス
• EDT
• 列挙型
• データエンティティ
• ビュー
• クエリ

開発ワークフローの例

1. 標準のD365実装を検索する
2. パターンを理解するためにソースファイルを読み取る
3. 既存のカスタマイズをワークスペース内で検索する
4. 洞察を組み合わせて新しいソリューションを生成する

例えば、次のようなプロンプトを使用します。

"Add a new field 'External name' on vendor group table and add it to form general tab"

期待される結果:

• AIがセマンティック検索を使用してD365アーティファクトを検索する
• ファイルパスを介して標準の実装を読み取る
• ワークスペース内の既存のカスタマイズをチェックする
• 完全なテーブルとフォームの拡張機能を生成する
• 適切なD365パターンを使用した単一のセッションですべてを行う

👉 完全なデモを見る

🔧 トラブルシューティング

ツールが読み込まれない場合

症状: MCPサーバーがクライアントに表示されるが、ツールが表示されない

解決策:

1. FOINDEX_API_KEY が正しく設定されていることを確認する (JSON内にクォートを含めず、余分なスペースを含めない)
2. AIクライアントを完全に再起動する (ウィンドウを再読み込みするだけではない)
3. クライアントの開発者コンソールでMCPサーバーのログを確認する
4. ターミナルで直接 npx fo-semantic-mcp をテストして、インストールを確認する

タイムアウトエラーの場合

症状: "Request timeout" または "Connection refused" エラー

解決策:

1. https://search.xplusplus.ai へのインターネット接続を確認する
2. タイムアウトを増やす: FO_SEARCH_TIMEOUT_MS 環境変数を設定する
3. 最新バージョンを使用していることを確認する

現在のバージョンを確認する:

# グローバルインストールの場合
npm list -g fo-semantic-mcp

# npxの場合 (最新の利用可能なバージョンを表示)
npm view fo-semantic-mcp version

npxで特定のバージョンを強制するには:

{
  "command": "npx",
  "args": ["-y", "fo-semantic-mcp@2.0.7"]
}

📖 v2.0.7の新機能

最新の修正点

• ✅ MCP STDIOプロトコル準拠 - Claude Desktopでの初期化タイムアウトを修正
• ✅ MCPレジストリ公開 - registry.modelcontextprotocol.ioの公式MCPカタログで検索可能になりました
• ✅ npmインストールサポート - npm install -g でインストールするか、npx で直接使用できる
• ✅ 文字エンコーディングの修正 - プロンプトと応答のクリーンな表示
• ✅ ログの改善 - すべてのログがSTDERRを使用して、適切なMCPプロトコル準拠を実現

以前のv2.0の改良点

• ✅ アーキテクチャの簡素化 - 簡潔なツールドキュメントとクリーンな応答
• ✅ 単一のプロンプト - 明確な fo-development-assistant プロンプト
• ✅ 標準のTypeScriptビルド - 透過性のために難読化を削除
• ✅ 本番環境対応パッケージ - 必要なランタイムファイルのみを含む
• ✅ より良いMCPの整合性 - 適切なMCPアーキテクチャパターンに従う

以前のバージョンからの移行

v1.xからの移行:

• APIに破壊的な変更はありません
• インストールを更新し、AIクライアントを再起動します
• 設定形式は互換性があります

v2.0.0 - 2.0.6からの移行:

• 最も簡単な更新方法としてnpxメソッドを使用します
• 設定を更新して npx コマンドを使用することを推奨します
• AIクライアントを再起動して新しいバージョンを読み込みます

🆘 サポート

• 問題報告: GitHub Issues でバグや機能要求を報告してください
• ドキュメント: Getting Started Guide を参照してください
• エンタープライズ: カスタムソリューションやエンタープライズサポートについては、contact@xplusplus.ai までお問い合わせください
• コミュニティ: GitHubで議論に参加してください

📄 ライセンス

このソフトウェアは商用利用向けにライセンスされています。詳細については、LICENSE ファイルを参照してください。

🚀 FO-Indexについて

FO-Index の開発チームによって構築されました。FO-Indexは、Microsoft Dynamics 365 Finance & Operations開発の包括的な知識ベースです。

私たちの使命: AIを通じて、Microsoftの膨大な標準アーティファクトライブラリを検索可能かつ理解しやすくすることで、D365 F&Oの開発を加速させることです。

F&O開発を強化したいですか？ APIキーを取得 して、今日から始めましょう！ 🎯