考古天文学计算引擎

Sky Culture MCP是一个用于计算古代文化中天体位置的模块化引擎,支持多种文化背景的天文数据转换,适用于历史天文研究和文化解读。

  • by nishanthabimanyu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nishanthabimanyu/sky-culture-mcp

使用说明

天空文化MCP:考古天文学计算引擎

更换镜头,而非望远镜

在我之前的翻译工作中 苏里亚·西丹塔,我花了几个月的时间手动计算行星位置,以验证古代梵文经文与现代星历表。这是一个为单一文化背景构建定制模拟的乏味、重复的过程。

当我继续学习玛雅和中国天文学时 最后一年项目我意识到我也犯了同样的错误:我正在为每种文化构建一个新的“望远镜”(模拟引擎)。

*天空文化MCP 作为解决方案而开发。它作为 核心计算模块 对于更广泛的项目来说,这代表了架构的转变。我没有重建望远镜,只是换了镜头。

这种模块化的“可互换镜头”使AI Agent能够抽象出轨道力学的复杂性。无论输入的是玛雅长计数日期还是汉代恒星名称,这个微服务都会处理物理问题,使Agent能够专注于文化解读。

技术架构

该模块实现 模型上下文协议(MCP) 将高精度天文函数暴露给像克劳德这样的大型语言模型(LLM)。

  • 星历表:美国国家航空航天局喷气推进实验室DE421(涵盖公元前1900年至公元2050年)。
  • 物理引擎:Skyfield(矢量天体测量)。
  • 时间标准:重心动态时间(TDB)。
  • 标准符合性国际天文学联合会恒星名称工作组。

集成指南:Claude Desktop

要将此引擎用作Claude的“镜头”,您必须在您的 claude_desktop_config.json.

先决条件:您必须安装并运行Docker。

  1. 找到您的配置文件:

    • 视窗: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. 添加 sky-culture-lite 进入 mcpServers 对象:

{
  "mcpServers": {
    "sky-culture-lite": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "yourname/sky-culture-lite"
      ]
    }
  }
}

注:更换 yourname/sky-culture-lite 如果你还没有推送到Docker Hub,可以使用你的本地镜像标签(例如。, sky-culture-lite).

暴露的功能

服务器向模型上下文协议(MCP)主机公开以下函数签名。

1. convert_culture_to_coordinates

签名: (culture_id: str, object_name: str, date_str: str) -> str

这是主要的“镜头”功能。它完成了从文化描述到科学载体的完整翻译。

  • 输入:
    • culture_id:目标文化背景(例如。, mayan, chinese_han).
    • object_name:天体的本名(例如。, chak_ek, yinghuo).
    • date_str:历史时代。支持 玛雅长计数 (M:b,k,t,u,k)以及 朱利安 (J:y,m,d)格式。
  • 退货:
    • 质心动力学时间(TDB)
    • 朱利安日数(JD)
    • J2000右倾上升和下降(ICRF)

2. list_cultures

签名: () -> str

返回当前加载的文化背景的目录。这允许代理人在选择镜片之前“调查”可用的镜片。

  • 退货:可用文化ID及其相关天体的格式化列表。

参考文献