天体MCP

天体の位置、日の出/日の入り時刻、その他の天文データを計算するためのツールを提供する、Claude AI 用のモデル コンテキスト プロトコル (MCP) サーバー。

概要

CelestialMCPはmcpフレームワークで構築されており、天文学エンジンライブラリを活用して正確な天文計算を提供します。天体の位置を特定したり、天体の出入り時刻を計算したり、恒星や深宇宙の天体カタログから利用可能な天体をリストアップしたりするためのツールが複数用意されています。

特徴

• 天体位置計算：地球上の指定された場所から任意の天体の高度と方位座標を取得します

• 日の出・日の入り時刻の計算：特定の場所から天体が昇る時刻、通過する時刻、沈む時刻を調べます

• 詳細な天体情報: 次のような天体に関する総合的な情報が得られます:

  • 距離（太陽系の天体の場合）

  • 満ち欠け情報（月と惑星）

  • 今後の月の満ち欠け（月の場合）

• 広範なオブジェクトカタログ: 含まれるもの:

  • 太陽系の天体（太陽、月、惑星）

  • HYGデータベースからの5,500以上の星

  • NGCカタログの14,000以上の深宇宙天体

ツール

パッケージには 3 つの主なツールが含まれています。

1. getCelestialPosition : 天体の高度/方位座標を計算します

2. getCelestialDetails : 天体に関する詳細情報を提供します

3. listCelestialObjects : カテゴリ別に利用可能な天体のリストを返します。

Related MCP server: chuk-mcp-celestial

クイックスタート

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

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
};

ライセンス

マサチューセッツ工科大学

謝辞

• 中核的な天文学計算のための天文学エンジン

• MCP サーバー実装用のmcp-framework

• 星データのHYGデータベース

• 深宇宙天体データ用のOpenNGC