GeoFS MCP 서버

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

특징

• 🛫 항공기 비행 매개변수(스로틀, 방향 등)를 제어합니다.
• 📊 실시간 비행 데이터(위치, 속도, 자세)에 접근하세요
• 🗺️ 경유지와 공항 간 이동
• ✈️ 다양한 항공기 모델을 선택하세요
• 🔄 비행 기동 실행(이륙, 착륙)

필수 조건

• 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도 지원합니다.

사용 가능한 명령:

• setThrottle - 엔진 스로틀 설정(0-1)
• setHeading - 목표 방향을 각도로 설정
• getPosition - 현재 항공기 위치 가져오기
• selectAircraft - 다른 항공기로 변경
• takeOff - 이륙 절차 실행
• land - 착륙 절차 실행
• getFlightData - 포괄적인 항공편 데이터 가져오기

예시 클라이언트

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

예제를 실행하려면:

작동 원리

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

기여하다

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

특허

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

감사의 말

• GeoFS - 브라우저 기반 비행 시뮬레이터
• 모델 컨텍스트 프로토콜 - AI 모델 컨텍스트에 대한 프로토콜 사양