위성 추적 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} : 지정된 위치 위의 위성 목록

설치

필수 조건

Node.js 18 이상
N2YO API 키( N2YO API 서비스 에서 사용 가능)

설정

이 저장소를 복제하거나 소스 코드를 다운로드하세요
종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

구성

서버가 작동하려면 N2YO API 키가 필요합니다. 환경 변수 N2YO_API_KEY 를 통해 이 키를 제공할 수 있습니다.

MCP 설정 구성

Claude와 함께 이 서버를 사용하려면 MCP 설정 구성 파일에 추가하세요.

Claude 데스크톱 앱(macOS)용

~/Library/Application Support/Claude/claude_desktop_config.json 편집합니다.

{
  "mcpServers": {
    "satellite-tracking": {
      "command": "node",
      "args": ["/path/to/satellite-tracking-server/build/index.js"],
      "env": {
        "N2YO_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude VSCode 확장 프로그램용

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 편집합니다.

{
  "mcpServers": {
    "satellite-tracking": {
      "command": "node",
      "args": ["/path/to/satellite-tracking-server/build/index.js"],
      "env": {
        "N2YO_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

사용 예

서버가 구성되고 실행되면 Claude와 함께 사용하여 위성 추적 데이터에 액세스할 수 있습니다.

위성 위치 가져오기

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_position</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060
}
</arguments>
</use_mcp_tool>

위성 TLE 데이터 가져오기

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellite_tle</tool_name>
<arguments>
{
  "norad_id": 25544
}
</arguments>
</use_mcp_tool>

시각적 패스 예측

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>predict_visual_passes</tool_name>
<arguments>
{
  "norad_id": 25544,
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "days": 7
}
</arguments>
</use_mcp_tool>

위성 검색

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>search_satellites</tool_name>
<arguments>
{
  "query": "ISS"
}
</arguments>
</use_mcp_tool>

위치 위에 위성 가져오기

<use_mcp_tool>
<server_name>satellite-tracking</server_name>
<tool_name>get_satellites_above</tool_name>
<arguments>
{
  "observer_lat": 40.7128,
  "observer_lng": -74.0060,
  "search_radius": 45
}
</arguments>
</use_mcp_tool>

위성 리소스에 액세스

<access_mcp_resource>
<server_name>satellite-tracking</server_name>
<uri>satellite://25544</uri>
</access_mcp_resource>

위성 카테고리

이 서버는 다음과 같은 위성 카테고리를 지원합니다.

카테고리 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 라이선스에 따라 라이선스가 부여되었습니다.

Satellite Tracking MCP Server

Integrations