Celestialmcp

🚀 天文MCP

このプロジェクトは、Claude AI用に設計されたモデルコンテキストプロトコル（MCP）サーバーです。天体の位置、昇降時刻、その他の天文データを計算するために使用されます。

🚀 クイックスタート

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

✨ 主な機能

概要

天文MCPは、mcp-frameworkをベースに構築され、astronomy-engineライブラリを使用して高精度の天文計算を実現しています。天体の位置を特定し、昇降時刻を計算し、恒星や深空天体のカタログから利用可能な天体をリストするための様々なツールを提供します。

機能

• 天体位置計算：地球上の特定の地点から見た天体の仰角と方位角を取得します。
• 昇降時刻計算：特定の地点から天体が昇る、天頂を通過する、沈む時刻を検索します。
• 詳細な天体情報：天体に関する包括的な情報を提供します。
  • 距離（太陽系天体の場合）
  • 位相情報（月や惑星）
  • 未来の月相（月のみ）
• 豊富な天体カタログ：
  • 太陽系天体（太陽、月、惑星）
  • HYGデータベースの5,500以上の恒星
  • NGCカタログの14,000以上の深空天体

ツール

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

1. getCelestialPosition：天体の仰角と方位角を計算します。
2. getCelestialDetails：天体の詳細情報を提供します。
3. listCelestialObjects：カテゴリ別に利用可能な天体のリストを返します。

📦 インストール

Claude Desktopとの連携

ローカル開発

Claude Desktopの設定ファイルに以下の内容を追加します。 Windows: %APPDATA%/Claude/claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "天文学MCP": {
      "command": "node",
      "args":["/path/to/celstial-mcp/index.js"]
    }
  }
}

星図データのダウンロード

以下のコマンドを実行して、恒星カタログをダウンロードし更新します。

npm run fetch catalogs

デフォルト設定

このプロジェクトでは、観測者の位置をバンクーバーに設定しています。具体的なパラメータは以下の通りです。

• 緯度: 49.2827° N
• 経度: 123.1207° W
• 標高: 0 m
• タイムゾーン: America/Vancouver

ユーザーはconfig.jsonを編集して、自身の位置パラメータを設定することができます。

💻 使用例

基本的な使用法

天体位置の照会

const response = await fetch('/api/celstial/position', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    celestialBody: 'Jupiter',
    date: new Date().toISOString()
  })
});

天体情報の取得

const response = await fetch('/api/celstial/details', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    celestialBody: 'Moon'
  })
});

📚 ドキュメント

プロジェクト構造

• src/
  • tools/：天文計算の核心ツールが格納されています。
  • utils/：補助機能のモジュールが格納されています。
  • config.js：設定管理ファイルです。
  • index.js：サーバーのエントリーポイントです。
• scripts/：データのダウンロードと処理のスクリプトが格納されています。
• data/：ローカルのカタログデータが格納されています。

注意事項

1. ネットワーク依存性：初回実行時には、初期の星図データをダウンロードするためにインターネット接続が必要です。
2. パフォーマンス最適化：計算負荷の高いタスクでは、キャッシュ機構を有効にすることをおすすめします。
3. エラー処理：本番環境では、適切なエラー捕捉とログ記録を設定することをおすすめします。

詳細な情報については、公式ドキュメントを参照してください。