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 | 计算本命盘（星体点、宫位、相位），可选附带解读文本，并返回简洁易读的摘要。 |
更多工具（行运、合盘、配对、月相、星盘图像等）即将推出。工具的可用性取决于你订阅的模块：你的套餐未包含的工具会返回明确的提示信息，而不是数据。
示例会话
与已连接的助手的对话可能如下所示：
你： 1985 年 3 月 3 日早上 6:45 出生在巴塞罗那的人，太阳星座和上升星座是什么？
助手： 先用 “Barcelona” 调用
astro_resolve_place，再用解析出的坐标和时区调用astro_natal_chart——太阳位于双鱼座 12°41′，落在第 1 宫，上升星座是水瓶座 28°10′……
助手会处理地理编码、时区转换和 API 调用——这些正是手动输入出生数据时最容易出错的环节。