SimBrief MCP 服务器

一个 Model Context Protocol 服务器，让 Claude Desktop 可以直接访问您的 SimBrief 飞行计划——无需 Cloudflare，无需 OAuth，也无需任何基础设施。

功能特性

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

所有工具都接受一个可选的 plan_id 参数——留空则始终获取您最新的调度计划。

Related MCP server: SimBrief Flight Planning MCP Server

要求

• 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

Lint 和格式化：

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