Simbrief Mcp Server

SimBrief MCP 服务

模型上下文协议 服务，让 Claude Desktop 可直接访问你的 SimBrief 飞行计划——无需 Cloudflare、OAuth 或基础设施。

功能

14 个工具，涵盖 SimBrief OFP 的所有部分：

工具	说明
get_flight_summary	航班号、飞机、航线、距离、巡航、ETE、燃油
get_weather	出发地、到达地和备降机场的 METAR、TAF 和 ATIS
get_fuel_plan	完整燃油明细：滑行、航程、应急、备降、储备、额外燃油
get_weights	OEW、业载、ZFW、TOW、停机坪重量、着陆重量
get_times	计划 OUT/OFF/ON/IN、ETE、航段时间、滑行时间、续航时间
get_atc_flightplan	可直接提交的 ATC 飞行计划字符串
get_aircraft_info	机型、注册号、发动机、设备代码
get_navlog	完整航路点列表，包含各航段的高度、距离和燃油
get_notams	所有 NOTAM（出发、到达、航路沿途）
get_alternate_info	备降机场详情和航路记录
get_performance	起飞和着陆性能（TLR），如有提供
get_crew	机长、副驾驶、签派员、乘务长、空乘人员
get_impacts	高度和成本指数变化对燃油和时间的影响
get_full_flight_plan	完整原始 JSON，供自定义分析使用

所有工具都接受可选的 plan_id 参数——留空即可始终获取最新的签派计划。

要求

• Python 3.11+
• uv
• SimBrief 账户（免费）

安装

git clone https://github.com/Emanuele94/SimBrief-MCPServer.git
cd SimBrief-MCPServer
uv sync

配置

你的 SimBrief Pilot ID 通过 MCP 配置中的环境变量传入——无需修改代码。

在 SimBrief → Account Settings → Pilot ID 中查找你的 Pilot ID。

集成 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "simbrief": {
      "command": "uv",
      "args": [
        "run",
        "--project", "/absolute/path/to/SimBrief-MCPServer",
        "python",
        "/absolute/path/to/SimBrief-MCPServer/server.py"
      ],
      "env": {
        "SIMBRIEF_PILOT_ID": "your_pilot_id_here"
      }
    }
  }
}

然后重启 Claude Desktop。SimBrief 工具将自动显示。

如果未设置 SIMBRIEF_PILOT_ID，服务将拒绝启动，并显示清晰的错误消息。

使用示例

连接后，你可以向 Claude 提出类似以下问题：

• “我最新的飞行计划是什么？”
• “显示我下一班航班的天气。”
• “我计划了多少燃油？具体明细是什么？”
• “给我完整的 ATC 飞行计划字符串。”
• “如果我降低 2000 英尺飞行，燃油消耗会有什么变化？”
• “显示我的航路记录中的前 20 个航路点。”

开发

安装开发依赖项：

uv sync --all-extras

运行测试：

uv run pytest -v

检查代码并格式化：

uv run ruff check .
uv run ruff format .

所有测试均可完全离线运行——SimBrief API 已模拟，因此无需互联网连接或真实的 Pilot ID。

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/my-feature）
3. 进行修改并添加测试
4. 确保 CI 流水线在本地通过（uv run pytest && uv run ruff check .）
5. 向 main 提交 Pull Request

PR 必须通过所有检查（测试 + lint）后才能合并。

许可证

MIT