一、周易大师 MCP 是什么
MCP（Model Context Protocol）是一种让 AI 客户端调用外部能力的开放协议。周易大师开放平台把 47 项周易数术能力封装为 34 个 zhouyi_* 工具，通过 MCP 暴露给你的客户端。接入后，你可以直接在对话里说”帮我排个六爻卦””看看 1990 年 1 月 1 日的八字”，客户端会自动调用对应工具并返回结果。
两种接入形态：
| 形态 | 说明 | 适合谁 |
|---|---|---|
| 云端直连（推荐） | 客户端直接连 https://openapi.jiuchongju.com/mcp，无需本地运行任何程序 |
绝大多数用户 |
| 自部署 | 在本机/服务器运行 Python MCP Server，客户端连本地端点 | 需要内网/定制的用户 |
MCP 与 Skill 包共用同一个 API-KEY 与每日额度（默认 500 次/日，合并计数）。
二、第一步：注册账号（以 jiuchongju001 为例）
- 打开官网 https://web.jiuchongju.com，点击右上角 「注册」（
/#/user/register）； - 填写：用户名
jiuchongju001、密码、确认密码、生日、出生时间、性别； - 提交后自动进入个人中心，注册完成。
字段说明与注意事项见《周易大师 Skill 使用指南》第二节，此处不赘述。
三、第二步：创建 API-KEY
- 登录后进入 「开放平台」→「API-KEY 管理」（或直达 API-KEY 管理页）；
- 点 「+ 创建 API-KEY」；
- 弹窗展示明文密钥（
sk-zhouyi-开头），立即复制保存（明文仅展示一次）； - 列表中长期显示掩码（如
sk-zho****at7Y）。
四、第三步：导出 MCP 配置包
- 在 API-KEY 管理页，对应 KEY 行点击 「导出 MCP 配置」（与「导出 Skill」并列）；
- 浏览器下载
zhouyi-mcp-config.json； - 该文件内容为标准
mcpServers配置 + 你的明文 KEY + 接入说明，形如：{ "mcpServers": { "zhouyi-master": { "type": "streamableHttp", "url": "https://openapi.jiuchongju.com/mcp", "headers": { "X-API-Key": "sk-zhouyi-你的KEY" } } } }
文件内已含你的 KEY，请勿外传或提交到公开代码仓库。
五、第四步：在客户端导入并使用
5.1 导入配置
把 zhouyi-mcp-config.json 的内容合并进客户端的 MCP 配置：
- Claude Desktop：编辑
claude_desktop_config.json的mcpServers段； - Qoder / Cursor：在设置 → MCP 中添加上述 server；
- 阿里云百炼等：按平台 MCP 接入入口粘贴配置。
若客户端不支持导入文件，可手动新建一个 server，填：
- 类型 / Type：
streamableHttp（或”远程 / URL”） - URL：
https://openapi.jiuchongju.com/mcp - 请求头 / Headers：
X-API-Key: sk-zhouyi-你的KEY（也支持Authorization: Bearer sk-zhouyi-你的KEY）
5.2 验证连接
重启客户端后，应能看到名为 zhouyi-master 的 server 处于已连接状态，并列出 34 个工具（如 zhouyi_bazi_fortune、zhouyi_paipan_liuyao、zhouyi_lingqian 等）。
5.3 对话调用示例
你：用六爻帮我测一下这次合作能不能成，用摇卦方式。
客户端：（调用zhouyi_paipan_liuyao，fangfa=摇卦）……返回卦象、世应、动爻与解读。
你：查一下我今天还剩多少额度。
客户端：（调用zhouyi_my_calls）……返回近期调用与剩余额度（此查询不消耗额度）。
六、（可选）自部署 MCP Server
若需在本机或内网运行：
- 准备 Python ≥ 3.10，创建虚拟环境并安装依赖：
python3.12 -m venv .venv .venv/bin/pip install mcp requests - 设置 KEY 并启动（默认监听
127.0.0.1:8000）：ZHOUYI_API_KEY=sk-zhouyi-你的KEY .venv/bin/python server.py # 端点：http://127.0.0.1:8000/mcp - 客户端配置改为本地端点：
{ "mcpServers": { "zhouyi-master": { "type": "streamableHttp", "url": "http://127.0.0.1:8000/mcp", "headers": { "X-API-Key": "sk-zhouyi-你的KEY" } } } } - 自检：
.venv/bin/python server.py --list-tools应打印 34 个工具。
生产建议监听
127.0.0.1并由 nginx 反代对外；普通用户直接用云端直连即可，无需自部署。
七、常用工具速览（共 34 个）
| 类别 | 代表工具 | 说明 |
|---|---|---|
| 排盘 | zhouyi_paipan_bazi / _ziwei / _liuyao / _qimen / _liuren / _feixing / _jinkoujue |
七种传统排盘 |
| 测算 | zhouyi_bazi_fortune / zhouyi_name_test / zhouyi_bone_weight |
八字、姓名、称骨 |
| 运势 | zhouyi_dayun / _liunian / _liuyue / _liuri |
大运与流年流月流日 |
| 签梦 | zhouyi_lingqian / zhouyi_dream |
五种灵签、周公解梦 |
| 配对 | zhouyi_match |
星座/姓名/属相/血型/QQ 配对 |
| 民俗 | zhouyi_huangli / zhouyi_omen / zhouyi_zodiac_personality |
黄历、征兆、属相性格 |
| 元信息 | zhouyi_my_calls |
调用记录与剩余额度（不耗额度） |
完整 34 个工具的入参说明，见客户端连接后的工具列表，或官网 API 文档页 API 文档。
八、额度与调用记录
- 默认 500 次/日，MCP 与 Skill 合并计数，每日 0 点重置；
- 成功响应末尾附「今日额度：已用 X/500」；
- 调用
zhouyi_my_calls查询明细与剩余（不消耗额度）； - 需提升额度：在 API-KEY 管理页「申请提升每日额度」，凭申请编号联系管理员开通。
九、常见问题（FAQ）
Q1：客户端提示连不上 / 不支持？
确认客户端支持远程 streamable-http MCP。仅支持旧版 stdio（本地拉起进程）的客户端需升级，或改用第六节自部署形态。
Q2：KEY 应该放哪里？
优先放请求头 X-API-Key（或 Authorization: Bearer）。导出的 zhouyi-mcp-config.json 已按此写好。避免把 KEY 作为对话内容发给模型。
Q3：返回 UNAUTHORIZED？
KEY 无效或缺失。检查请求头是否带上、KEY 是否以 sk-zhouyi- 开头、是否被重新生成过（旧 KEY 失效）。
Q4：返回 QUOTA_EXCEEDED？
当日 500 次用尽。次日 0 点重置，或申请提升额度。
Q5：MCP 和 Skill 包有什么区别？
能力等价（同一套 47 项功能）。MCP 走协议直连，适合支持 MCP 的客户端；Skill 包是解压即用的技能目录，适合按技能加载的平台。二者共用额度。
Q6：调用结果有可视化页面吗？
含渲染结果的工具会返回自包含 HTML 结果页（与移动端同款样式），客户端可保存打开。
十、获取帮助
- 官网与注册：https://web.jiuchongju.com
- 云端 MCP 端点：https://openapi.jiuchongju.com/mcp
- 额度 / 故障联系管理员：kongqingzhu@outlook.com
本指南基于平台当前版本编写；界面文案以线上实际为准。