셀레스티얼MCP

Claude AI를 위한 MCP(Model Context Protocol) 서버로, 천체 위치, 일출/일몰 시간 및 기타 천문 데이터를 계산하는 도구를 제공합니다.

개요

CelestialMCP는 mcp 프레임워크로 구축되었으며, 천문학 엔진 라이브러리를 활용하여 정확한 천문 계산을 제공합니다. 천체의 위치 결정, 일출 및 일몰 시간 계산, 그리고 별과 심우주 천체 목록에서 이용 가능한 천체 목록 생성을 위한 다양한 도구를 제공합니다.

특징

• 천체 위치 계산 : 지구상의 지정된 위치에서 모든 천체의 고도 및 방위각 좌표를 가져옵니다.

• 상승/진행 시간 계산 : 천체가 특정 위치에서 떠오르고, 이동하고, 진행하는 시점을 찾습니다.

• 자세한 천체 정보 : 다음을 포함한 천체에 대한 포괄적인 정보를 얻으세요.

  • 거리(태양계 천체에 대한)

  • 위상 정보(달과 행성에 대한)

  • 다가오는 달의 위상(달의 경우)

• 광범위한 객체 카탈로그 : 다음이 포함됩니다.

  • 태양계 천체(태양, 달, 행성)

  • HYG 데이터베이스에서 5,500개 이상의 별점 획득

  • NGC 카탈로그에 있는 14,000개 이상의 심우주 천체

도구

패키지에는 세 가지 주요 도구가 포함되어 있습니다.

1. getCelestialPosition : 천체의 고도/방위각 좌표를 계산합니다.

2. getCelestialDetails : 천체에 대한 자세한 정보를 제공합니다.

3. listCelestialObjects : 범주별로 사용 가능한 천체 목록을 반환합니다.

Related MCP server: chuk-mcp-celestial

빠른 시작

지엑스피1

Claude Desktop과 함께 사용

지역 개발

Claude Desktop 구성 파일에 다음 구성을 추가하세요.

Windows : %APPDATA%/Claude/claude_desktop_config.json MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "CelestialMCP": {
      "command": "node",
      "args":["/absolute/path/to/CelestialMCP/dist/index.js"]
    }
  }
}

카탈로그 데이터

이 프로젝트에는 천문학 카탈로그 데이터를 가져오는 스크립트가 포함되어 있습니다.

# Fetch star and deep sky object catalogs
npm run fetch-catalogs

이렇게 하면 HYG 별 데이터베이스와 NGC 심원천체 카탈로그가 data/ 디렉토리에 다운로드됩니다.

도구 사용

다음은 Claude와 함께 도구를 사용하는 몇 가지 예입니다.

객체 위치 가져오기

클로드에게 물어보세요: "밴쿠버에서 본 하늘에서 목성의 현재 위치는 어디인가요?"

객체 세부 정보 가져오기

클로드에게 물어보세요: "오늘 밴쿠버의 달은 언제 뜨고 언제 지는가요?"

사용 가능한 객체 나열

클로드에게 물어보세요: "내가 찾아볼 수 있는 별 목록을 보여주세요."

프로젝트 구조

CelestialMCP/
├── src/
│   ├── tools/            # MCP Tools
│   │   ├── CelestialPositionTool.ts
│   │   ├── CelestialDetailsTool.ts
│   │   └── ListCelestialObjectsTool.ts
│   ├── utils/
│   │   └── astronomy.ts  # Core astronomy calculations
│   ├── config.ts         # Observer configuration
│   └── index.ts          # Server entry point
├── scripts/
│   └── fetch-catalogs.js # Script to download star catalogs
├── data/                 # Catalog data files
│   ├── hygdata_v41.csv   # HYG star database
│   └── ngc.csv           # New General Catalogue
├── package.json
└── tsconfig.json

기본 구성

기본적으로 관찰자의 위치는 캐나다 밴쿠버로 설정되어 있습니다. src/config.ts 에서 이 설정을 변경할 수 있습니다.

export const OBSERVER_CONFIG = {
  latitude: 49.2827,    // Observer latitude
  longitude: -123.1207, // Observer longitude
  altitude: 30,         // Observer altitude in meters
  temperature: 15,      // Default temperature in Celsius
  pressure: 1013.25     // Default pressure in hPa
};

특허

MIT

감사의 말

• 핵심 천문학 계산을 위한 천문학 엔진

• MCP 서버 구현을 위한 mcp-framework

• 별 데이터를 위한 HYG 데이터베이스

• 심층 하늘 객체 데이터를 위한 OpenNGC