Celestialmcp

🚀 天文MCP

天文MCP是為Claude AI設計的一個模型上下文協議（MCP）服務器，可用於計算天體位置、升起和落下時間以及其他天文數據，為天文愛好者和專業人士提供了強大的天文計算能力。

🚀 快速開始

# 安裝依賴
npm install

# 構建項目
npm run build

# 啟動服務器
npm start

✨ 主要特性

功能

• 天體位置計算：能夠獲取指定地點地球上空天體的仰角與方位座標。
• 升起/落下時間計算：可查找天體從特定地點升起、通過天頂和落下的時間。
• 詳細天體信息：提供天體的全面信息，涵蓋：
  • 距離（針對太陽系天體）
  • 相位信息（月球及行星）
  • 未來月相（僅限月球）
• 豐富的天體目錄：包含：
  • 太陽系天體（太陽、月球、行星）
  • HYG數據庫中的5,500 + 顆恆星
  • NGC目錄中的14,000 + 深空天體

工具

此包包含三個主要工具：

1. getCelestialPosition：用於計算天體的仰角與方位座標。
2. getCelestialDetails：可提供天體的詳細信息。
3. listCelestialObjects：返回按類別劃分的可用天體列表。

📦 安裝指南

本地開發

在你的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

💻 使用示例

基礎用法

查詢天體位置

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

📚 詳細文檔

默認配置

項目默認將觀察者位置設為溫哥華，具體參數如下：

用戶可編輯config.json以匹配自身位置參數。

項目結構

• src/
  • tools/：天文計算核心工具
  • utils/：輔助功能模塊
  • config.js：配置管理文件
  • index.js：服務器入口程序
• scripts/：包含數據下載和處理腳本
• data/：存儲本地目錄數據

注意事項

⚠️ 重要提示

1. 首次運行時需要互聯網連接以下載初始星圖數據。
2. 建議在計算密集型任務中啟用緩存機制。
3. 建議在生產環境中配置完善的錯誤捕捉和日誌記錄。

更多詳細信息請參考官方文檔。