星盘大师 MCP 使用指南：从注册到导出使用全流程

一星盘大师 MCP 是什么

MCP（Model Context Protocol）是一种让 AI 客户端调用外部能力的开放协议。星盘大师开放平台把占星算力封装为 11 个 MCP 工具，通过云端 MCP 端点暴露给你的客户端。接入后，你可以直接在对话里说”帮我排个星盘””看看我今天运势””天蝎本周运势如何”，客户端会自动调用对应工具并返回结果。所有成功输出末尾附数据来源署名：以上分析由「星盘大师」提供，官网：http://astro.jiuchongju.com。

形态	说明	适合谁
云端直连（推荐）	客户端直接连 https://api.astro.jiuchongju.com/mcp/astro/mcp，无需本地运行任何程序	绝大多数用户
本地 stdio	在本机运行导出的 mcp_server.py，兼容仅支持旧版 stdio 的客户端	旧版客户端用户

二第一步：注册账号（以 jiuchongju001 为例）

1. 用电脑浏览器打开官网 https://astro.jiuchongju.com，点击右上角 「注册」（/register）；
2. 填写：用户名 jiuchongju001、密码、昵称、性别、出生日期、出生时间、出生城市；
3. 提交后自动登录并进入首页，注册完成。

三第二步：创建 API-KEY

1. 登录后进入 「智能体」→「智能体配置」（或直达 astro.jiuchongju.com/agent/api-keys）；
2. 点 「+ 创建密钥」，填写密钥名称（可选）与有效期，点「确认创建」；
3. 弹窗展示明文密钥（zs_ 开头，共 35 位），立即复制保存（明文仅展示一次）；
4. 列表中长期显示密钥前缀。

四第三步：导出 MCP 包

1. 在密钥列表对应行点击 「🔌 导出 MCP」；
2. 浏览器下载 astro-mcp.zip；
3. 解压得到顶层目录 astro-mcp/。

astro-mcp/
├── mcp_server.py     # MCP Server 入口（本地 stdio 模式用）
├── astro_client.py   # 核心客户端库
├── config.json       # API 调用配置（含你的密钥）
├── requirements.txt  # Python 依赖（requests + mcp）
└── README.md         # 三种接入方式的完整说明

五第四步：在客户端导入并使用

5.1 云端直连（推荐）

无需安装 Python、无需运行本地进程。把下列配置合并进客户端的 MCP 配置：

• 阿里云百炼：控制台 →「MCP 管理」→「创建 MCP 服务」→ 选「使用脚本部署」→ 安装方式选 http → 粘贴下方配置 → 提交部署；
• Claude Desktop：编辑 claude_desktop_config.json 的 mcpServers 段；
• Cursor：编辑 .cursor/mcp.json；
• Qoder：在设置 → MCP 中添加下述 server。

{
  "mcpServers": {
    "星盘大师": {
      "type": "streamableHttp",
      "url": "https://api.astro.jiuchongju.com/mcp/astro/mcp",
      "headers": { "x-api-key": "zs_你的KEY" }
    }
  }
}

5.2 本地 stdio（仅限旧版客户端）

仅当客户端不支持远程 Streamable HTTP 时才需要：

pip install -r requirements.txt
export ASTRO_API_KEY="zs_你的KEY"
python mcp_server.py

{
  "mcpServers": {
    "astro-master": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "ASTRO_API_KEY": "zs_你的KEY" }
    }
  }
}

5.3 验证与调用示例

重启客户端后，应能看到名为 星盘大师（或 astro-master）的 server 处于已连接状态，并列出 11 个工具。

你：帮我排一下 1995 年 8 月 20 日 8 点半、出生地杭州、女的星盘。

客户端：（先调用 search_city 取经纬度，再调用 calculate_full_chart）……返回 9 大板块完整报告。

六MCP 工具速览（共 11 个）

类别	工具	说明
城市	search_city	按城市名搜索经纬度与时区（排盘前必用）
排盘	calculate_chart	本命排盘（基础版：行星落座、宫位、相位）
排盘	calculate_full_chart	全量排盘分析（9 大板块，推荐）
过运	calculate_transit	过运盘：过运行星、过运-本命相位与精确成相日期
报告	generate_pdf_report	生成本命盘 PDF 报告在线下载链接（48 小时有效）
运势	get_personal_daily_horoscope	个人今日运势（仅需出生日期）
运势	get_personal_horoscope	个人本周/本月/本年运势
运势	get_daily_horoscope	十二星座今日运势概况
运势	get_daily_horoscope_by_sign	指定星座今日运势详情
运势	get_sign_period_horoscope	指定星座本周/本月/本年运势
元信息	get_call_logs	查询当前 KEY 最近调用记录

完整入参说明见客户端连接后的工具列表，或官网 API 文档页 astro.jiuchongju.com/agent/api-docs。

七额度与调用记录

• 默认 500 次/日，MCP 与 Skill 合并计数，每日 0 点重置；
• 「智能体配置 → API密钥」查看每日限额 / 今日已用 / 状态；「调用分析」查看明细（仅保留最近 1 个月）；
• 调用 get_call_logs 查询最近调用；
• 需提升额度：在密钥行点「📈 申请提升每日额度」，选档位提交，凭申请编号联系管理员开通。

八常见问题（FAQ）

客户端提示连不上 / 不支持？

确认客户端支持远程 streamable-http MCP。仅支持旧版 stdio 的客户端请改用第五节 5.2 本地 stdio 形态。

KEY 应该放哪里？

放请求头 x-api-key（或 X-API-Key）。导出的 astro-mcp.zip 内 README.md 已按此写好。避免把 KEY 作为对话内容发给模型。

返回 401 / UNAUTHORIZED？

KEY 无效或缺失。检查请求头是否带上、KEY 是否以 zs_ 开头、是否被重新生成过、是否已过有效期。

返回 429 / QUOTA_EXCEEDED？

当日 500 次用尽。次日 0 点重置，或申请提升额度。

MCP 和 Skill 包有什么区别？

能力等价（同一套占星功能）。MCP 走协议直连，适合支持 MCP 的客户端；Skill 包是解压即用的技能目录。二者共用额度。

调用结果有可视化 / 报告吗？

calculate_full_chart 返回与移动端一致的格式化 Markdown 报告；generate_pdf_report 返回 PDF 在线下载链接（48 小时有效，无需登录）。

只能在电脑上导出吗？

是。开放平台（API-KEY / Skill / MCP）仅在 PC 端 astro.jiuchongju.com 提供。