开发者

占星 MCP 服务器

把 Claude、ChatGPT、Cursor 或 VS Code 连接到 Swiss Ephemeris。你的助手会先计算星盘,再解读它:真实的位置、宫位、相位、行运和地点,而不是猜测。

✦ Swiss Ephemeris✦ 每天免费 10 次调用✦ 从不保存出生信息

更新于 · 下次复核

服务器 URL:https://www.natalchart.ai/mcp。它通过 Streamable HTTP 使用 Model Context Protocol(模型上下文协议),因此任何支持远程 MCP 服务器的客户端都能使用它。向你的助手要一张星盘、一份匹配度解读,或者最适合搬去的城市,它会先调用下面的工具获取数字。

两分钟完成连接

  1. 创建一个免费 API 密钥。它以 nc_live_ 开头,只显示一次。
  2. 按下面针对各客户端的说明,把服务器添加到你的助手中。
  3. 就星盘提问:“我于1991年9月6日 10:45 出生在乌克兰的乔尔诺莫尔斯克。我的上升星座是什么?我的第 10 宫在工作方面说明了什么?”

Claude(claude.ai 和 Claude Desktop)

打开“设置”,再进入“连接器”,添加一个自定义连接器,然后粘贴下面这个 URL,并用你的密钥替换 YOUR_KEY:

https://www.natalchart.ai/mcp?key=YOUR_KEY

ChatGPT

在 ChatGPT 的设置中开启开发者模式后,用同一个 URL 创建一个不需要身份验证的连接器。密钥包含在 URL 中。

Claude Code

claude mcp add --transport http natalchart https://www.natalchart.ai/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

在 ~/.cursor/mcp.json 中:

{
  "mcpServers": {
    "natalchart": {
      "url": "https://www.natalchart.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json 中;VS Code 只会询问一次密钥,并且不会把它写进文件:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "natalchart-key",
      "description": "NatalChart.AI API key",
      "password": true
    }
  ],
  "servers": {
    "natalchart": {
      "type": "http",
      "url": "https://www.natalchart.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:natalchart-key}"
      }
    }
  }
}

工具

工具方案返回内容
natal_chart免费根据出生信息生成的本命盘。"part" 决定返回哪些内容:full(全部内容:天体的星座、度数、速度、逆行标记和宫位;四轴;十二个普拉西度制(Placidus)宫头;相位及其容许度;元素与模式分布;恒星接触)、short(太阳、月亮和上升点,每个天体所在的星座,逆行的天体,主导元素与主导模式),或者其中一部分:planets, angles, houses, aspects, elements, fixed-stars。默认为 full。
daily_transits免费计算出的当日数据:UTC 正午的天空、月相、未来一周的天象事件;如果提供出生信息,还包括对本命盘的每个行运及其容许度。不含生成的文字。
sky免费某一日期的行星位置、月相和未来一周的天象事件(?date=YYYY-MM-DD,默认为今天)。
usage免费你的方案、今天的已用次数,以及额度何时恢复。不消耗额度。
transitsAPI Pro最长 92 天时间段内的全部行运事件:按日期列出行运天体与本命盘形成的精确相位、进入星座和停滞。
synastryAPI Pro比较两张星盘:两盘之间的相位及容许度,双向的宫位叠加,以及每个生活领域的评分。
solar_returnAPI Pro某一年的太阳回归盘,可按出生地或其他地点起盘。
best_daysAPI Pro针对一项活动(general、business、romance、health、creative、travel、home、clarity),为最长 62 天时间段内的每一天评分:有利和不利的行运、月相与月亮星座、月亮空亡。最好的五天排在最前。
location_scoreAPI Pro一个地点对照一张星盘:迁移后的四轴、落在四轴上的行星及其容许度、每个生活领域的评分和总评分。
best_citiesAPI Pro按一张星盘为主要城市目录排名,可按总体或所选的生活领域,在全球或某一地区范围内。

出生信息在所有工具中都一样:date 采用 YYYY-MM-DD 格式,time 为当地时间,采用 HH:mm 格式,未知时为 null;还有 latitude 和 longitude,以及可选的 IANA timezone。助手会自行查找出生地的坐标。出生时间未知时,所有依赖时间的内容(上升点、宫位)都不予给出,而不是去猜测。

限额与价格

方案价格工具调用次数工具
免费$0每天 10 次natal_chart, daily_transits, sky, usage
API Pro每月 $6.99每天 1,000 次全部工具:行运、合盘、太阳回归、最佳日子、地点

MCP 服务器是 NatalChart.AI API 的一部分:一个密钥,一份每日额度,一个订阅。未通过校验的调用不消耗额度;用免费密钥调用 Pro 工具时,它会回复如何获得该工具;usage 始终免费。

为什么需要计算服务器

语言模型擅长解释星盘,却不擅长计算星盘:让它们凭记忆说出月亮星座或上升点,常常会出错,而回答本身也看不出来。有了这个服务器,位置数据来自 Swiss Ephemeris,也就是 NatalChart.AI 星盘计算器所用的引擎,精度报告也将它与 NASA 的 JPL Horizons 进行了核对。之后,模型就去做它擅长的事。

常见问题

什么是 MCP 服务器?

MCP,即 Model Context Protocol,是 AI 助手调用外部工具的方式。连接这个服务器后,助手就能计算星盘,而不是猜测:它会用你提供的出生信息调用 natal_chart,在回答之前读取真实的位置、宫位和相位。

这个服务器会撰写解读吗?

不会。每个工具都只以 JSON 返回计算结果,别无其他:没有生成的文字,我们这边也不使用 AI。解读由你的助手来写,依据的是正确的数字。

我需要写代码吗?

不需要。创建一个免费密钥,把一个 URL 作为自定义连接器粘贴到 Claude 或 ChatGPT 中,然后就星盘提问。开发者可以把同一个服务器添加到 Claude Code、Cursor 或 VS Code,并把密钥放在请求头中。

我可以调用多少次?

每次工具调用消耗一次请求:免费方案每天 10 次,API Pro(每月 $6.99)每天 1,000 次。MCP 服务器和 REST API 共用同一个密钥和同一份每日额度,额度在 UTC 时间 00:00 恢复。连接服务器和列出工具不消耗额度。

把密钥放在 URL 里安全吗?

请像对待密码一样对待这个 URL:任何拿到它的人都能消耗你每天的请求次数。支持请求头的客户端(Claude Code、Cursor、VS Code)应改为以 Authorization: Bearer 的形式发送密钥。泄露的密钥可以在控制台中立即撤销。

出生信息会被保存吗?

不会。服务器计算并作答;请求体从不写入任何地方。日志记录的是工具名称、状态和耗时。

它使用哪种黄道和分宫制?

回归黄道和普拉西度制宫位,五种主要相位,与 NatalChart.AI 应用的设置相同。不提供恒星黄道、吠陀占星和其他分宫制。

准备好查看你自己的星盘了吗?

生成我的免费星盘