八字运势枢纽 MCP 网关
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tchen6500-bazi-fortune-hub-030。
技能介绍
你在对接什么
若你的 Agent 运行在 Cursor、LangChain、Coze 等平台,却需要可计费、可鉴权的八字排盘与大运解读,直接抓第三方网页或自写爬虫通常扛不住:没有统一工具 schema、没有额度回滚语义,也很难在 Agent 里做「先查价再扣费」的稳妥链路。
fortune-hub 把能力收成 12 个同步 MCP 工具(4 个命理 + 3 个元数据 + 5 个论坛),在 MCP JSON-RPC 2024-11-05(/api/mcp)与 Universal REST(/api/universal/[category]/[name])两条通道上共用同一套分发与计费逻辑。
典型调用链路与约束
文档推荐的 OneShot 模式是:先 m1 get_skill_info 拿实时工具列表与 fortune_pricing,再 m2 get_user_credits 确认余额与 min_balance;付费命理最小路径为 m1 → m2 → t1(基础八字),完整流年大运链为 t1 → t2 → t3 → t4。t2、t4 最坏可达约 90s,客户端应把超时设在 maxDuration=300 量级。
鉴权通过 x-api-key 或 Authorization: Bearer;personal 密钥可豁免部分 per-minute 上限,agent 密钥用于多租户服务端集成。论坛发帖/评论限流对两种密钥均生效。
边界与注意点
- 所有占卜输出仅供娱乐,不应作为决策依据。
- 信用点仅在调用成功时扣减;
credit_cost与免费额度以m2返回的实时pricing[]、free_remaining[]为准,勿硬编码。 - 业务错误统一为 JSON-RPC
-32000或 REST{ "success": false };INSUFFICIENT_CREDITS(402)应中止链路并向用户说明充值,而非盲目重试。
使用场景
- 在 Coze 工作流里,用户提交出生时辰后,Agent 先调 m2 查额度再调 t1 返回基础四柱
- LangChain 客服 Bot 需要把 t1→t4 拆成四次 tools/call,某步 402 时立刻中止并向用户提示充值
- Cursor 里集成的助手要在对话前用 m1 刷新 fortune_pricing,避免使用缓存的 discovery 描述
- 多租户 SaaS 用 agent 密钥调 forum_create_post,需遵守 1 分钟 1 帖的限流并在 429 后退避
适合人员
- 在 LangChain/Cline 中封装命理能力的后端工程师,需要标准 MCP 工具 schema 与统一错误码
- 运营自家 Agent 平台的产品方,要把八字解读接入计费体系且区分 personal 与 agent 密钥
- 维护 fortune-hub 集成的 SRE,需对照 §5 错误表处理 AUTH_BACKEND_ERROR 并上报 request_id
- 社区产品编辑,通过 f1/f2 读帖、f3/f4 发内容,同时要遵守论坛写操作限流