Simconnect MCP Server

MCP Server in TypeScript that exposes the SimConnect API of Microsoft Flight Simulator 2024 as MCP tools, resources, and prompts — enabling Claude to fully control the simulator.

______________________________________________________________________

安装

第一步——安装Node.js

需要Node.js 18或更高版本。下载 长期支持 版本从 .

安装后，关闭并重新打开终端，然后验证：

node -v   # should print v18.x.x or higher
npm -v    # should print 9.x.x or higher

步骤2——克隆和构建

git clone https://github.com/jctommasi/simconnectmcp.git
cd simconnectmcp
npm install
npm run build

npm install 下载所有依赖项，包括 节点simconnect （SimConnect SDK的Node.js绑定——不需要单独下载SDK）。

npm run build 将TypeScript编译为 dist/ 文件夹。

步骤3——验证Microsoft飞行模拟器2024

MSFS 2024必须安装在同一台机器上。服务器通过SimConnect命名管道与模拟器通信，这些管道由MSFS自动配置。

要确认SimConnect可用，请检查此文件是否存在：

%APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml

此文件由MSFS在首次启动时创建。如果不存在，请在运行服务器之前至少启动一次MSFS 2024。

注： 必须运行模拟器才能连接MCP服务器。服务器包含指数回退的自动重新连接功能，因此如果MSFS尚未运行，它将不断重试。

步骤4-WASimCommander WASM模块（可选）

WASimCommander是一个开源WASM模块，它公开了MSFS内部的扩展变量访问。它是 不需要 对于基本操作，服务器可以在没有它的情况下完全工作。但是，它为复杂的附加飞机（PMDG、FlyByWire等）解锁了这些功能：

安装WASM模块：

1. 从下载最新版本 .
2. 在发布zip中，找到名为的文件夹 wasimcommander-module （或类似）。
3. 将该文件夹复制到您的MSFS中 社区 文件夹：

   %APPDATA%\Microsoft Flight Simulator 2024\Packages\Community\

1. 重新启动MSFS 2024。WASM模块在启动时自动加载。

注： 目前没有WASimCommander的原生Node.js客户端库。服务器通过动态导入检测并使用一个(wasim-client)如果可用。在此之前，WASimCommander工具会返回一个描述性错误——服务器正常启动和运行，这些功能会正常降级。

步骤5——配置服务器

A. simconnect-mcp.config.json 文件提供了默认值。根据需要进行自定义：

{
  "safetyProfile": "safe",
  "logLevel": "info",
  "maxSubscriptions": 50,
  "reconnectMaxDelayMs": 30000
}

安全简介

步骤6-Claude桌面集成

将服务器添加到Claude Desktop配置文件中：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "simconnect-msfs2024": {
      "command": "node",
      "args": ["C:/Users/YOUR_USER/path/to/simconnect-mcp-server/dist/index.js"]
    }
  }
}

看 claude_desktop_config.example.json 一个完整的模板。

快速验证

# 1. Build succeeded
ls dist/index.js        # should exist

# 2. Start in dev mode (MSFS must be running)
npm run dev

# 3. You should see log output on stderr indicating:
#    - MCP server started
#    - SimConnect attempting connection (or connected if MSFS is running)
#    - WASimCommander status (available or gracefully disabled)

按 Ctrl+C 停止开发服务器。

______________________________________________________________________

用法

# Development (with hot reload)
npm run dev

# Production
npm run build
npm start

# Or run directly via bin
npx simconnect-mcp-server

______________________________________________________________________

Claude代码Slash命令

使用此项目时 克劳德代码，以下斜线命令可用：

飞行计划

/sync-fly-plan 确保SimConnect已连接，然后调用 load_flight_plan 无需任何争论，它可以自动解析MSFS 2024 CUSTOMFLIGHT.PLN 通过 %APPDATA%.

时间加速

自主阶段管理

/crusader --将sim速率设置为64×，然后进行监视 GPS ETE 和 PLANE ALTITUDE 定期地。当飞机稳定在巡航高度（垂直速度接近0，连续检查2次以上）时，它会报告“已达到巡航阶段”，并保持64倍运行，直到另有指示。

/go-to-dest --将sim速率设置为64×，然后进行监视 GPS ETE 每30秒（实时）。当ETE降至600秒以下时，它降至1×并报告： *“接近目的地——模拟速率1×。准备输入交通模式。”*

______________________________________________________________________

可用工具

连接与安全

SimVar访问

事件

飞机位置

发动机控制

自动驾驶

无线电和导航

飞行计划

飞机系统

模拟控制

WASimCommander（扩展访问）

______________________________________________________________________

资源

______________________________________________________________________

提示

______________________________________________________________________

许可证

麻省理工学院