Msfs Sdk MCP

🚀 MSFS SDK MCP Server

Microsoft Flight Simulator SDKのドキュメントに自然言語と構造化クエリを通じて高速かつ構造化されたアクセスを提供する、最新かつ高性能なMCPサーバーです。

🚀 クイックスタート

このサーバーを使用することで、Microsoft Flight Simulator SDKのドキュメントに高速かつ構造化されたアクセスが可能になります。以下のセクションで、セットアップ手順や機能、使用方法などを詳しく説明します。

✨ 主な機能

• ⚡️ 公式のMSFS SDKドキュメント内でのリアルタイムドキュメント検索
• 📚 複数の検索カテゴリ：目次、索引、用語集、全て
• 🧠 自然言語処理：「Search livery op msfs sdk」のようなクエリに対応
• 📊 構造化された結果：タイトル、URL、説明、カテゴリ
• 📄 特定のドキュメントページからの詳細コンテンツ取得
• 🔌 AIアシスタントやツールとの完全なMCP互換性
• 💾 埋め込みデータ：外部ファイル不要
• 🛡️ 強力なエラーハンドリングとロギング

🔧 技術詳細

🛠️ 技術スタック

• ランタイム：Node.js 18+
• 言語：TypeScript 5.0
• フレームワーク：Model Context Protocol (MCP)
• HTTPクライアント：node-fetch
• HTMLパーサー：Cheerio
• ブラウザ自動化：Puppeteer (オプション)
• ビルドツール：TypeScriptコンパイラ

📦 インストール

📋 必要条件

• Node.js 18.x以上
• npm 8.x以上
• TypeScript 5.x

🚀 セットアップ手順

1. リポジトリをクローンする：

git clone https://github.com/yourusername/msfs-sdk-mcp.git
cd msfs-sdk-mcp

2. 依存関係をインストールする：

npm install

3. プロジェクトをビルドする：

npm run build

4. サーバーを起動する：

npm start

💻 使用例

🔌 利用可能なツール

🏷️ 検索カテゴリ

• contents - 📖 メインのドキュメントコンテンツ
• index - 📇 ドキュメントの索引エントリ
• glossary - 📚 技術用語と定義
• all - 🌐 すべてのカテゴリを検索する（デフォルト: 索引）

🔌 AIアシスタントとの統合

このサーバーは、以下のようなMCP互換のAIアシスタントと連携して動作します。

• 🤖 Claude Desktop - 公式のMCPサポート
• 🌊 Windsurf IDE - 組み込みのMCP統合
• 🔧 その他のMCPクライアント - すべてのMCP互換ツール

⚙️ 設定例

{
  "mcpServers": {
    "msfs-sdk": {
      "command": "node",
      "args": ["path/to/msfs-sdk-mcp/dist/index.js"]
    }
  }
}

📚 ドキュメント

📈 ツールの使用例

🔍 search_msfs_docs

{
  "name": "search_msfs_docs",
  "arguments": {
    "query": "livery",
    "category": "all",
    "limit": 10
  }
}

📋 list_category_items

{
  "name": "list_category_items",
  "arguments": {
    "category": "glossary"
  }
}

📄 get_doc_content

{
  "name": "get_doc_content",
  "arguments": {
    "url": "https://docs.flightsimulator.com/html/...",
    "section": "overview"
  }
}

🌐 検索URL形式

https://docs.flightsimulator.com/html/Introduction/Introduction.htm?rhsearch={query}&agt={category}

パラメータ：

• {query} - 🔍 検索用語（URLエンコード済み）
• {category} - 🏷️ オプションのカテゴリ（index, glossary, または目次用の空文字列）

📊 レスポンス形式

{
  "content": [
    {
      "type": "text",
      "text": "**Title**\n- Category: category\n- URL: url\n- Description: description"
    }
  ]
}

🤝 コントリビューション

1. 🍴 このリポジトリをフォークする
2. 🌱 機能ブランチを作成する：git checkout -b feature-name
3. ✨ 変更を実装してテストする
4. 📝 明確なメッセージでコミットする：git commit -am 'Add new feature'
5. 🚀 ブランチにプッシュする：git push origin feature-name
6. 📩 プルリクエストを作成する

📅 コミット規約

• feat: - 新機能
• fix: - バグ修正
• docs: - ドキュメント更新
• refactor: - コードリファクタリング
• test: - テスト追加

📄 ライセンス

MITライセンス – 詳細はLICENSEファイルを参照してください。

📞 サポートと連絡先

• 🐛 問題報告：GitHub Issues
• 📚 MSFS SDKドキュメント：公式ドキュメント
• ❓ 新しい問題？ 明確な情報と再現手順を提供してください。

📅 変更履歴

v1.0.0 - 🎉 初期リリース

• ✨ 初期リリース - 完全なMCPサーバー実装
• 🔍 リアルタイムドキュメント検索 - MSFS SDKドキュメントへの高速アクセス
• 📚 複数の検索カテゴリ - 目次、索引、用語集のサポート
• 🧠 自然言語処理 - 直感的なクエリ処理
• 🔌 MCP標準サポート - 完全な互換性
• 💾 埋め込みデータ - 外部依存関係なし

⚠️ 免責事項

⚠️ 重要提示

このツールは非公式のものであり、MicrosoftまたはMicrosoft Flight Simulatorとは関係ありません。公式のMSFS SDKウェブサイトを通じて公開ドキュメントにアクセスするためのものです。

🚀 Happy Flying! ✈️