SimBrief MCP 서버

Claude Desktop이 SimBrief 비행 계획에 직접 액세스할 수 있도록 하는 Model Context Protocol 서버입니다. Cloudflare, OAuth, 인프라가 필요하지 않습니다.

기능

SimBrief OFP의 모든 섹션을 다루는 14개의 도구:

모든 도구는 선택적 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 → 계정 설정 → 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. 저장소를 포크합니다.

2. 기능 브랜치를 생성합니다 (git checkout -b feature/my-feature).

3. 변경 사항을 적용하고 테스트를 추가합니다.

4. CI 파이프라인이 로컬에서 통과하는지 확인합니다 (uv run pytest && uv run ruff check .).

5. main 브랜치에 대한 Pull Request를 엽니다.

PR은 병합되기 전에 모든 검사(테스트 + 린트)를 통과해야 합니다.

라이선스

MIT