服务器 URL:https://www.natalchart.ai/mcp。它通过 Streamable HTTP 使用 Model Context Protocol(模型上下文协议),因此任何支持远程 MCP 服务器的客户端都能使用它。向你的助手要一张星盘、一份匹配度解读,或者最适合搬去的城市,它会先调用下面的工具获取数字。
两分钟完成连接
- 创建一个免费 API 密钥。它以
nc_live_开头,只显示一次。 - 按下面针对各客户端的说明,把服务器添加到你的助手中。
- 就星盘提问:“我于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 | 免费 | 你的方案、今天的已用次数,以及额度何时恢复。不消耗额度。 |
transits | API Pro | 最长 92 天时间段内的全部行运事件:按日期列出行运天体与本命盘形成的精确相位、进入星座和停滞。 |
synastry | API Pro | 比较两张星盘:两盘之间的相位及容许度,双向的宫位叠加,以及每个生活领域的评分。 |
solar_return | API Pro | 某一年的太阳回归盘,可按出生地或其他地点起盘。 |
best_days | API Pro | 针对一项活动(general、business、romance、health、creative、travel、home、clarity),为最长 62 天时间段内的每一天评分:有利和不利的行运、月相与月亮星座、月亮空亡。最好的五天排在最前。 |
location_score | API Pro | 一个地点对照一张星盘:迁移后的四轴、落在四轴上的行星及其容许度、每个生活领域的评分和总评分。 |
best_cities | API 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 应用的设置相同。不提供恒星黄道、吠陀占星和其他分宫制。