标签： MCP

周易大师 MCP 接入指南：从注册到导出使用全流程

一、周易大师 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

本指南基于平台当前版本编写；界面文案以线上实际为准。

2026年9月12日

周易大师 Skill 使用指南：从注册到导出全流程

一、周易大师 Skill 是什么

周易大师开放平台把 47 项周易数术能力（八字测算、七种排盘、运势流年、抽签解梦、配对合婚、民俗预测等，编号 F1–F47）对外开放，提供三种接入方式：

接入方式	适合谁	产物
Skill 包	想让 AI 助手”会说周易”的用户	`zhouyi-master-skill.zip`，解压即用
MCP 服务	使用支持 MCP 协议客户端的开发者	`zhouyi-mcp-config.json` 配置
开放 API	自建系统的开发者	HTTPS 接口（`/api/open/**`）

三种方式共用同一个 API-KEY 与每日额度（默认 500 次/日，Skill 与 MCP 合并计数），计量口径完全一致。本指南聚焦最常用的 Skill 包 路线。

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

浏览器打开官网 https://web.jiuchongju.com；
点击右上角 「注册」 按钮，进入注册页（/#/user/register）；
按下表填写并提交：

字段	示例值	说明
用户名	`jiuchongju001`	3–50 个字符，登录与展示用
密码	（自设强密码）	建议字母+数字+符号组合
确认密码	与密码一致	二次校验
生日	如 1990-01-01	命理计算的默认个人信息
出生时间	如 08:30	时辰影响排盘结果
性别	男 / 女	部分测算区分性别

提交成功后自动跳转到 个人中心（/#/user/center），注册完成。

提示：生日、出生时间、性别会作为排盘测算的默认个人信息，之后每次测算可临时修改，不影响账号本身。

三、第二步：创建 API-KEY

API-KEY 是你调用所有开放能力的”钥匙”，以 sk-zhouyi- 开头。

登录后，在侧边栏或顶部菜单的 「开放平台」 分组中点击 「API-KEY 管理」；也可直接访问 API-KEY 管理页；
点击蓝色按钮 「+ 创建 API-KEY」；
弹窗显示 「API-KEY 创建成功」，其中：
- 密钥：完整明文，如 sk-zhouyi-V8LsizYyqUmB82rQTUcXNPXjFUHWat7Y；
- 掩码：如 sk-zho****at7Y，列表中长期展示的形式；
立即点击「复制密钥」并妥善保存，然后点「我已保存」关闭弹窗。

⚠️ 重要：密钥明文仅在创建 / 重新生成时展示一次，关闭弹窗后无法再次查看，列表只显示掩码。请务必当场复制保存。若遗失，可在列表行内点「重新生成」获取新密钥（旧密钥随即失效）。

创建成功后，列表会出现一行记录，包含：API-KEY（掩码）、创建时间、当前每日限额（默认 500 次）、额度有效期、状态（正常）。

四、（可选）申请提升每日额度

默认每个 KEY 每日 500 次调用。若不够用：

在 API-KEY 管理页，对应行点击 「申请提升每日额度」；
在弹窗中填写期望额度与理由，提交；
系统返回 申请编号（如「申请编号为「QD…」、联系管理员付费后开通」）；
凭申请编号联系管理员完成付费开通，额度生效后实时生效。

五、第三步：导出 Skill 包

在 API-KEY 管理页，对应 KEY 行点击 「导出 Skill」；
浏览器自动下载 zhouyi-master-skill.zip；
该包与你的 API-KEY 一一绑定：包内配置已注入你的密钥，无需手动填写；
每次导出都会在后台生成一条 导出记录（可在管理端按用户 / KEY / 日期查询），便于追溯。

一个 KEY 可多次导出；每次导出的包内容一致（均为该 KEY 的专属配置）。

六、第四步：安装并使用 Skill 包

解压 zhouyi-master-skill.zip，得到顶层目录 zhouyi-master-skill/，结构大致为：

zhouyi-master-skill/
├── SKILL.md          # 技能说明（含 YAML frontmatter，已注入你的账号与 KEY）
├── config.yaml       # 账户与密钥配置（已填好，无需改）
├── scripts/          # 调用脚本（CLI 子命令覆盖 47 项能力）
└── ...               # 渲染模板、说明文档等

放入你的 Agent 平台技能目录：
- Claude Desktop / Claude Code：放入其 skills / plugins 目录；
- Qoder：放入工作区 .qoder/skills/；
- Cursor、ClawHub 等：按各自技能加载规范放置。
在对话中直接下达命理任务，Agent 会自动调用 Skill。例如：

你：帮我用八字看看 1990 年 1 月 1 日 8 点半、男、出生地杭州的运势。
Agent：（调用 zhouyi_bazi_fortune）……返回排盘与解读，并附可视化结果页。
每次调用消耗每日额度；成功响应会附「今日额度：已用 X/500」。

七、（可选）改用 MCP 接入

若你的客户端支持 MCP 协议（Claude Desktop、Qoder、Cursor、阿里云百炼等），可免本地部署、直连云端：

在 API-KEY 管理页，对应行点击 「导出 MCP 配置」，下载 zhouyi-mcp-config.json；

将该文件导入客户端的 MCP 配置；或手动配置云端端点：

{
  "mcpServers": {
    "zhouyi-master": {
      "type": "streamableHttp",
      "url": "https://openapi.jiuchongju.com/mcp",
      "headers": { "X-API-Key": "sk-zhouyi-你的KEY" }
    }
  }
}

配置完成后，客户端即获得 34 个 zhouyi_* 工具，能力与 Skill 包等价。

MCP 与 Skill 共用每日额度，二者调用合并计数。

八、查看用量、调用记录与 API 文档

用量与状态：API-KEY 管理页列表直接展示「当前每日限额 / 额度有效期 / 状态」；
调用分析：用户中心「开放平台」分组内的调用分析页，可查看近期调用明细；
API 文档：访问 API 文档页，覆盖 47 项能力的逐接口参数表，并附 Skill 与 MCP 两种接入说明；
调用记录工具：在 Agent 中调用 zhouyi_my_calls 可查询最近调用与剩余额度（不消耗额度）。

九、常见问题（FAQ）

Q1：密钥明文忘了保存怎么办？
在 API-KEY 管理页对应行点「重新生成」，弹窗会再次展示新明文（旧密钥立即失效）。请当场复制。

Q2：调用返回”每日调用限额 500 次”（QUOTA_EXCEEDED）怎么办？
说明当日额度用尽。可次日 0 点自动重置，或按第四节申请提升额度；也可注册独立账户分散用量。

Q3：Skill 和 MCP 的额度是分开的吗？
不分开。同一 KEY 下 Skill 与 MCP 合并计数，共用每日 500 次（或你申请的额度）。

Q4：导出的 Skill 包能给别人用吗？
包内已绑定你的 API-KEY，他人使用将消耗你的额度。请勿外传；如需为他人开通，请让其自行注册并导出。

Q5：KEY 会泄露吗？
列表仅展示掩码；服务端日志、错误文案、结果页均不输出明文 KEY。请仅通过请求头（X-API-Key）或包内 config 使用，避免贴到公开渠道。

Q6：支持哪些测算能力？
共 47 项（F1–F47）：八字/紫微/六爻/奇门/大六壬/玄空/金口诀七种排盘、大运流年流月流日、姓名测试与起名、抽签解梦、配对合婚、黄历、民俗预测等，详见 API 文档页。

十、获取帮助

官网与注册：https://web.jiuchongju.com
额度 / 故障联系管理员：kongqingzhu@outlook.com
开放 API 与 MCP 端点：https://openapi.jiuchongju.com

本指南基于平台当前版本编写；界面文案以线上实际为准。

2026年9月12日