GeoFS MCP 서버

GeoFS 비행 시뮬레이터를 위한 모델 컨텍스트 프로토콜(MCP) 서버로, AI 모델이 GeoFS 브라우저 기반 비행 시뮬레이터에서 항공기를 제어하고 항공기와 상호 작용할 수 있도록 합니다.

특징

• 🛫 항공기 비행 매개변수(스로틀, 방향 등)를 제어합니다.

• 📊 실시간 비행 데이터(위치, 속도, 자세)에 접근하세요

• 🗺️ 경유지와 공항 간 이동

• ✈️ 다양한 항공기 모델을 선택하세요

• 🔄 비행 기동 실행(이륙, 착륙)

Related MCP server: TAK Server MCP

필수 조건

• Node.js(v14 이상)

• npm 또는 yarn

• 최신 웹 브라우저(Chrome 권장)

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 종속성 설치:

   npm install

3. 프로젝트를 빌드하세요:

   npm run build

용법

서버 시작

1. MCP 서버를 시작합니다.

   npm start

2. 서버는 GeoFS로 이동하는 브라우저 창을 시작합니다.

   • 필요한 경우 GeoFS에 로그인해야 할 수도 있습니다.

   • 서버는 명령을 수락하기 전에 GeoFS가 완전히 로드될 때까지 기다립니다.

3. MCP 서버는 다음 위치에서 사용할 수 있습니다.

   • HTTP: http://localhost:3000

   • 웹소켓: ws://localhost:3000

AI 모델과 함께 사용

이 MCP 서버는 모델 컨텍스트 프로토콜을 지원하는 AI 모델과 함께 사용하여 다음을 수행할 수 있습니다.

1. 시뮬레이터에서 항공기 제어

2. 비행 데이터 및 시뮬레이터 상태 검색

3. 복잡한 비행 기동을 실행하세요

4. 비행 경로를 계획하고 따르세요

API 엔드포인트

• GET /mcp - 서버 기능 및 사용 가능한 엔드포인트 가져오기

• GET /mcp/aircraft - 현재 항공기 데이터 가져오기

• POST /mcp/aircraft - 항공기 매개변수 제어

• GET /mcp/flight-data - 포괄적인 비행 데이터 가져오기

• POST /mcp/navigation - 탐색 매개변수 설정

• GET /mcp/simulation - 시뮬레이션 상태 가져오기

• POST /mcp/simulation - 시뮬레이션 매개변수 제어

웹소켓 명령

서버는 실시간 통신을 위해 WebSocket도 지원합니다.

// Example WebSocket message
{
  "id": 1,
  "type": "command",
  "command": "setThrottle",
  "params": {
    "value": 0.75
  }
}

사용 가능한 명령:

• setThrottle - 엔진 스로틀 설정(0-1)

• setHeading - 목표 방향을 각도로 설정

• getPosition - 현재 항공기 위치 가져오기

• selectAircraft - 다른 항공기로 변경

• takeOff - 이륙 절차 실행

• land - 착륙 절차 실행

• getFlightData - 포괄적인 항공편 데이터 가져오기

예시 클라이언트

GeoFS MCP 서버에 연결하고 사용하는 방법에 대한 기본적인 예는 examples/simple-client.js 파일을 참조하세요.

예제를 실행하려면:

node examples/simple-client.js

작동 원리

GeoFS MCP 서버는 Puppeteer를 사용하여 GeoFS를 실행하는 브라우저 인스턴스를 제어합니다. 이 서버는 AI 모델이 HTTP 및 WebSocket API를 통해 비행 시뮬레이터와 상호 작용할 수 있도록 표준화된 MCP 인터페이스를 제공합니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• GeoFS - 브라우저 기반 비행 시뮬레이터

• 모델 컨텍스트 프로토콜 - AI 모델 컨텍스트에 대한 프로토콜 사양