MCP 服务器：在 AI 助手中使用 AstroAPI
AstroAPI 提供托管的 Model Context Protocol（MCP）服务器。将它连接到 Claude Code、Claude Desktop 或 Cursor 等 AI 助手后，助手就可以直接调用 AstroAPI——查询出生地点、计算星盘，并用通俗的语言解释结果。
这也是构建集成最快的方式：将 MCP 服务器连接到你的 AI 编程助手，然后让它为你编写集成代码。助手在工作时可以发起真实的 API 调用，因此它看到的是实际响应，而不是靠猜测。
无需编写代码
连接后，你只需向助手提问，例如：“计算 1990 年 6 月 15 日下午 2:30 出生在阿姆斯特丹的人的本命盘”——助手会解析地点、调用 API 并总结结果。
Endpoint
https://mcp.astroapi.cloud/mcp- 传输方式：Streamable HTTP
- 身份验证：你的常规 AstroAPI 密钥，通过
X-Api-Key请求头发送 - 你的订阅所包含的模块、速率限制和配额与直接调用 API 时完全一致。
你可以在控制台的 API Keys 下创建 API 密钥。详情请参阅身份验证。
连接 Claude Code
在终端中运行一次以下命令：
claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
--header "X-Api-Key: YOUR_API_KEY"然后直接让 Claude Code 使用 AstroAPI——例如：“使用 astroapi 工具计算 1990-06-15 14:30 阿姆斯特丹的本命盘，并为我构建一个用于展示它的 React 组件。”
连接 Cursor
将以下内容添加到项目中的 .cursor/mcp.json（或全局的 ~/.cursor/mcp.json）：
{
"mcpServers": {
"astroapi": {
"url": "https://mcp.astroapi.cloud/mcp",
"headers": {
"X-Api-Key": "YOUR_API_KEY"
}
}
}
}连接其他 MCP 客户端
任何支持通过 Streamable HTTP 使用 MCP 并支持自定义请求头的客户端都可以使用。配置如下：
| 设置 | 值 |
|---|---|
| URL | https://mcp.astroapi.cloud/mcp |
| 传输方式 | Streamable HTTP |
| 请求头 | X-Api-Key: YOUR_API_KEY |
不支持自定义请求头的托管客户端
某些托管客户端（例如 claude.ai 的网页连接器）无法发送自定义请求头，需要使用 OAuth。OAuth 支持已在路线图中；目前请使用支持自定义请求头的客户端，例如 Claude Code、Claude Desktop 或 Cursor。
可用工具
| 工具 | 功能 |
|---|---|
astro_resolve_place | 查询地名并返回坐标和 IANA 时区。助手被要求先调用此工具，因此它们绝不会靠猜测确定坐标。 |
astro_natal_chart | 计算本命盘（星体点、宫位、相位），可选附带解读文本，并返回简洁易读的摘要。 |
astro_synastry | 比较两张出生星盘，并列出双向的盘间相位。 |
astro_composite | 计算组合盘（中点合盘），包含其自身的星体位置和相位。 |
astro_transits | 查找一段时间内（最长 2 年）行运对本命盘的影响：每个相位的开始、准确和结束日期。 |
astro_compatibility | 基于太阳星座的两人快速配对评分。 |
astro_solar_return | 指定年份的太阳返照盘（占星意义上的生日星盘）。 |
astro_lunar_return | 从指定日期起的月亮返照盘（大约每月一次）。 |
astro_progressions | 目标日期的次限推运，包括与本命盘的相位。 |
astro_human_design | 完整的人类图（Human Design）人体图：类型、策略、内在权威、人生角色、能量中心、通道和闸门。 |
astro_moon_sun | 指定日期和地点的月相，以及日出日落、太阳正午和晨昏蒙影时间。 |
astro_moon_calendar | 单日报告（星座、月相、月空亡）或一段时间内的月相、换座和空亡时段概览。 |
astro_retrograde_calendar | 逆行时段，包含留驻日期、经过的星座和阴影期。 |
astro_chinese_horoscope | 中国生肖及五行，或年度运势预测。 |
astro_numerology | 根据出生日期和姓名生成完整的数字命理档案，或仅返回生命灵数。 |
astro_numerology_compatibility | 基于生命灵数的两人配对分析。 |
astro_horoscope | 预先撰写的每日、每周、年度及按上升星座的年度运势报告。 |
astro_ai_summary | 根据最重要的星体落点与相位，用几句话总结这份星盘的含义。需要 AI Summary 模块。 |
更多工具（占星地图、星盘图像等）即将推出。工具的可用性取决于你订阅的模块：你的套餐未包含的工具会返回明确的提示信息，而不是数据。
示例会话
与已连接的助手的对话可能如下所示：
你： 1985 年 3 月 3 日早上 6:45 出生在巴塞罗那的人，太阳星座和上升星座是什么？
助手： 先用 “Barcelona” 调用
astro_resolve_place，再用解析出的坐标和时区调用astro_natal_chart——太阳位于双鱼座 12°41′，落在第 1 宫，上升星座是水瓶座 28°10′……
助手会处理地理编码、时区转换和 API 调用——这些正是手动输入出生数据时最容易出错的环节。