위성 추적 MCP 서버
N2YO API를 사용하여 위성 추적 데이터에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.
특징
이 MCP 서버는 다음과 같은 기능을 제공합니다.
도구
get_satellite_position : NORAD ID로 위성의 실시간 위치를 가져옵니다.
get_satellite_tle : NORAD ID로 위성의 TLE(Two-Line Element) 데이터를 가져옵니다.
predict_visual_passes : 특정 위치 위의 위성의 가시 통과를 예측합니다.
predict_radio_passes : 특정 위치 상공의 위성의 무선 주파수 통과를 예측합니다.
get_satellites_above : 지정된 위치 위에 현재 있는 위성을 가져옵니다.
search_satellites : 이름이나 카테고리로 위성 검색
자원
satellite://{norad_id} : NORAD ID별 위성 정보
satellites://category/{category_id} : 특정 카테고리의 위성 목록
satellites://above/{lat}/{lon}/{radius} : 지정된 위치 위의 위성 목록
Related MCP server: MISP-MCP-SERVER
설치
필수 조건
Node.js 18 이상
N2YO API 키( N2YO API 서비스 에서 사용 가능)
설정
이 저장소를 복제하거나 소스 코드를 다운로드하세요
종속성 설치:
지엑스피1
서버를 빌드하세요:
구성
서버가 작동하려면 N2YO API 키가 필요합니다. 환경 변수 N2YO_API_KEY 를 통해 이 키를 제공할 수 있습니다.
MCP 설정 구성
Claude와 함께 이 서버를 사용하려면 MCP 설정 구성 파일에 추가하세요.
Claude 데스크톱 앱(macOS)용
~/Library/Application Support/Claude/claude_desktop_config.json 편집합니다.
Claude VSCode 확장 프로그램용
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 편집합니다.
사용 예
서버가 구성되고 실행되면 Claude와 함께 사용하여 위성 추적 데이터에 액세스할 수 있습니다.
위성 위치 가져오기
위성 TLE 데이터 가져오기
시각적 패스 예측
위성 검색
위치 위에 위성 가져오기
위성 리소스에 액세스
위성 카테고리
이 서버는 다음과 같은 위성 카테고리를 지원합니다.
카테고리 ID | 설명 |
0 | 모두 |
1 | 아마추어 |
2 | 큐브샛 |
3 | 교육 |
4 | 공학 |
5 | 갈릴레오 |
6 | 글로옵스 |
7 | GPS-OPS |
8 | 군대 |
9 | 레이더 |
10 | 의지 |
11 | 사르삿 |
12 | 과학 |
13 | TDRSS |
14 | 날씨 |
15 | XM/시리우스 |
16 | 이리듐-넥스트 |
17 | 글로벌스타 |
18 | 인텔샛 |
19 | 세스 |
20 | 텔레샛 |
21 | 오브컴 |
22 | 고리존트 |
23 | 라두가 |
24 | 몰니야 |
25 | 디엠씨 |
26 | 아르고스 |
27 | 행성 |
28 | 첨탑 |
29 | 스타링크 |
30 | 원웹 |
API 키 제한 사항
N2YO API는 구독 플랜에 따라 사용 제한이 있습니다. 무료 티어에서는 다음이 허용됩니다.
시간당 1,000개의 요청
모든 엔드포인트에 걸친 기본 기능
할당량을 초과하지 않으려면 서버를 사용할 때 이러한 제한 사항을 인지하세요.
문제 해결
API 키 오류 : N2YO API 키가 유효하고 환경 변수에 올바르게 설정되어 있는지 확인하세요.
속도 제한 : 속도 제한 오류가 발생하면 서버는 지수적 백오프로 자동으로 재시도하지만 추가 요청을 하기 전에 기다려야 할 수도 있습니다.
데이터가 없습니다 . 일부 위성은 특히 오래되었거나 비활성화된 위성의 경우 실시간 추적 데이터를 이용할 수 없습니다.
특허
이 프로젝트는 ISC 라이선스에 따라 라이선스가 부여되었습니다.