SimBrief MCP Server

Сервер Model Context Protocol, который предоставляет Claude Desktop прямой доступ к вашим планам полетов SimBrief — без Cloudflare, без OAuth, без необходимости в инфраструктуре.

Возможности

14 инструментов, охватывающих каждый раздел OFP SimBrief:

Все инструменты принимают необязательный параметр 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

Конфигурация

Ваш Pilot ID в SimBrief передается через переменную окружения в конфигурации MCP — изменения в коде не требуются.

Найдите свой Pilot ID в разделе SimBrief → Account Settings → 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 .

Все тесты выполняются полностью в автономном режиме — API SimBrief имитируется, поэтому подключение к интернету или реальный Pilot ID не требуются.

Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку для функции (git checkout -b feature/my-feature)

3. Внесите изменения и добавьте тесты

4. Убедитесь, что CI-конвейер проходит локально (uv run pytest && uv run ruff check .)

5. Откройте Pull Request в main

PR должны пройти все проверки (тесты + линтинг), прежде чем они смогут быть объединены.

Лицензия

MIT