MSFS SDK MCP 服务器

一个现代、高性能的MCP服务器，用于通过自然语言和结构化查询快速、有组织地访问Microsoft Flight Simulator SDK文档。

<a href="https://glama.ai/mcp/servers/@90barricade93/MSFS-SDK-MCP"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=402634499,1624296546&fm=3081&app=3081&f=PNG?w=760&h=400" alt="MSFS SDK Server MCP服务器" /> </a>

🚀 特性

• ⚡️ 实时文档搜索 在官方MSFS SDK文档中进行实时搜索
• 📚 多个搜索类别：内容、索引、术语表、全部
• 🧠 自然语言处理：如“搜索livery op msfs sdk”这样的查询
• 📊 结构化结果：标题、URL、描述、类别
• 📄 详细内容检索 从特定文档页面获取详细内容
• 🔌 完全兼容MCP 与AI助手和工具兼容
• 💾 嵌入数据：无需外部文件
• 🛡️ 强大的错误处理 和日志记录

🛠️ 技术栈

• 运行时：Node.js 18+
• 语言：TypeScript 5.0
• 框架：模型上下文协议（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
   

🔧 可用工具

工具	描述	参数
search_msfs_docs	🔍 搜索MSFS SDK文档	query, category, limit
get_doc_content	📄 获取详细内容	url, section
list_categories	📚 显示所有搜索类别	-
list_category_items	📋 列出每个类别的项目	category
natural_language_query	🧠 自然语言查询	query

🏷️ 搜索类别

• 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"]
    }
  }
}

📁 项目结构

msfs-sdk-mcp/
├── 📄 package.json             # 依赖项和脚本
├── 📄 tsconfig.json            # TypeScript配置
├── 📄 README.md               # 项目文档
├── 📄 LICENSE                 # MIT许可证
├── 📂 src/
│   ├── 📄 index.ts            # 🚀 主MCP服务器
│   └── 📂 services/
│       ├── 📄 documentationService.ts  # 🔍 搜索逻辑
│       └── 📄 naturalLanguageService.ts # 🧠 NLP处理
└── 📂 dist/                   # 🏗️ 编译后的JavaScript

🧪 开发与脚本

脚本	描述	命令
🏗️ 构建	编译TypeScript	npm run build
👀 开发	监控模式开发	npm run dev
🚀 开始	启动MCP服务器	npm start
🔍 类型检查	TypeScript验证	npx tsc --noEmit

📚 API参考

📈 工具示例

🔍 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": "**标题**\n- 类别：类别\n- URL：URL\n- 描述：描述"
    }
  ]
}

🤝 贡献

1. 🍴 分叉此仓库
2. 🌱 创建功能分支：git checkout -b feature-name
3. ✨ 实现并测试更改
4. 📝 提交带有清晰信息的更改：git commit -am '添加新功能'
5. 🚀 推送到你的分支：git push origin feature-name
6. 📩 打开拉取请求

📅 提交约定

• feat: - 新功能
• fix: - 错误修复
• docs: - 文档更新
• refactor: - 代码重构
• test: - 测试增加

📄 许可证

MIT许可证 - 详情见LICENSE文件。

📞 支持与联系

• 🐛 问题：GitHub问题
• 📚 MSFS SDK文档：官方文档
• ❓ 新问题？ 提供清晰的信息和可重现的步骤

📅 更新日志

v1.0.0 - 🎉 初始发布

• ✨ 初始发布 - 完整的MCP服务器实现
• 🔍 实时文档搜索 - 快速访问MSFS SDK文档
• 📚 多个搜索类别 - 支持内容、索引、术语表
• 🧠 自然语言处理 - 直观的查询处理
• 🔌 MCP标准支持 - 完全兼容
• 💾 嵌入数据 - 无外部依赖

---

⚠️ 免责声明

这是一个非官方工具，不隶属于Microsoft或Microsoft Flight Simulator。 提供通过官方MSFS SDK网站访问公共文档的功能。

🚀 祝飞行愉快！ ✈️

---

<div align="center">

  © 90barricade93 - aero-ai-solutions.com  

</div>