astronomy-oracle

Astronomy Oracle

为大模型助手提供准确的天文星表数据和观测时段规划。避免虚构星等、坐标和可见性信息。

功能

• 3 个工具，用于天体查询、星表搜索和观测时段规划
• 13,000+ 个深空天体，来自 OpenNGC 星表（NGC、IC、Messier 及补充天体）
• 确定性的天文学计算 — 儒略日、恒星时、地平坐标转换、升起／中天／落下时间
• 无需网络连接 — 数据均已打包，所有计算均在本地完成

安装

使用 npx 直接运行：

npx astronomy-oracle

或全局安装：

npm install -g astronomy-oracle

配置

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "astronomy-oracle": {
      "command": "npx",
      "args": ["-y", "astronomy-oracle"]
    }
  }
}

Claude Code

claude mcp add astronomy-oracle -- npx -y astronomy-oracle

工具参考

lookup_object

按 Messier 编号、NGC／IC 编号或常用名称查询天体。也可根据给定的位置和时间计算可见性。

{
  "name": "lookup_object",
  "arguments": {
    "name": "M31",
    "latitude": 51.5,
    "longitude": -0.1,
    "date": "2025-06-15T22:00:00Z"
  }
}

返回详细的天体数据：类型、坐标（RA／Dec）、星等、角尺寸、面亮度、哈勃类型、交叉引用，以及（提供位置时）当前高度角／方位角和升起／中天／落下时间。

search_objects

按类型、星座、星等范围、角尺寸或所属星表搜索和筛选星表。

{
  "name": "search_objects",
  "arguments": {
    "type": "PN",
    "constellation": "Lyr",
    "maxMagnitude": 12.0,
    "limit": 10
  }
}

返回按亮度排序的匹配天体格式化表格。支持按天体类型（星系、行星状星云、疏散星团等）、星座、星等范围、最小角尺寸和星表（Messier、Caldwell、NGC、IC）筛选。

plan_session

根据给定的位置和日期生成观测时段计划。返回按时间段分组的最佳观测天体。

{
  "name": "plan_session",
  "arguments": {
    "latitude": 40.7,
    "longitude": -74.0,
    "date": "2025-03-20",
    "minAltitude": 20,
    "maxMagnitude": 10.0,
    "types": ["G", "PN", "GCl"]
  }
}

将天体分为三个时段（傍晚、午夜、黎明前），并根据高度角、星等和角尺寸评估其可观测性。

数据来源

来源	许可证	说明
OpenNGC	CC-BY-SA 4.0	NGC／IC／Messier 星表，包含坐标、星等、尺寸和交叉引用

OpenNGC 数据依据 Creative Commons Attribution-ShareAlike 4.0 International License 提供。完整署名信息请参阅 OpenNGC 仓库。

开发

# Run tests
npm test

# Build
npm run build

# Run in development mode (tsx)
npm run dev

# Open MCP Inspector
npm run inspect

许可证

代码采用 MIT 许可证。OpenNGC 数据采用 CC-BY-SA 4.0 许可证。