标签：周易大师

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

标签： 周易大师

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

一、周易大师 MCP 是什么

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

三、第二步：创建 API-KEY

四、第三步：导出 MCP 配置包

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

5.1 导入配置

5.2 验证连接

5.3 对话调用示例

六、（可选）自部署 MCP Server

七、常用工具速览（共 34 个）

八、额度与调用记录

九、常见问题（FAQ）

十、获取帮助

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

一、周易大师 Skill 是什么

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

三、第二步：创建 API-KEY

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

五、第三步：导出 Skill 包

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

七、（可选）改用 MCP 接入

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

九、常见问题（FAQ）

十、获取帮助

标签：周易大师