开发者接入

MCP 2024-11-05

将任意 AI agent 或应用接入八字 MCP 网关——通过 MCP JSON-RPC 或通用 REST 调用 12 个工具。获取密钥、发现工具集，然后运行算命工具链。

快速开始

三步完成从零到第一次算命解读。

1创建账号

2创建 Agent Key

控制台 → API Keys → 新建密钥 → 选择 Agent Key。密钥仅显示一次。

打开控制台

3发现工具集

实时获取工具列表、版本和定价——切勿硬编码积分数值。

# Public discovery — no auth, cached 5 min
curl https://fortunehub.lighttune.com.au/.well-known/mcp.json

# Or call meta tool get_skill_info via MCP
curl -X POST https://fortunehub.lighttune.com.au/api/mcp \
  -H "x-api-key: bz_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_skill_info","arguments":{}}}'

端点与鉴权

两种传输方式共用同一张分发表——鉴权、限流、计费和错误码的行为完全一致。

方法	路径	用途
POST	/api/mcp	MCP JSON-RPC（协议 2024-11-05）
POST	/api/universal/[category]/[name]	通用 REST——每个工具一个路径
GET	/.well-known/mcp.json	公开发现端点（无需鉴权，缓存 5 分钟）
GET

12 个工具

3 个 meta（免费）+ 4 个算命（收费）+ 5 个社区（免费）。费用在请求时实时读取定价。

#	类别	工具	费用	鉴权
m1	meta	get_skill_info	免费	无需
m2	meta	get_user_credits	免费	必填
m3	meta	get_usage_history	免费	必填
t1	算命

下载 Skill 包

对外发布的 skill 包（SKILL.md、参考文档、示例），适用于 Cursor / Cline / LangChain / Coze / 自定义 agent。

下载 Skill（ZIP）在 GitHub 查看

或克隆仓库：

git clone https://github.com/tchen6500/fortune-hub-skill.git

查看完整定价管理 API Key

所有算命结果仅供娱乐参考。

算命工具链（须按 1 → 2 → 3 → 4 顺序调用）

每一步都依赖上一步的输出——切勿并行调用。

[1] bazi_basic_analysis        → base_context
    ↓
[2] bazi_pattern_analysis      → pattern_result        (LLM ~25s)
    ↓
[3] bigluck_year_analysis      → year_analysis_result
    ↓
[4] bigluck_year_fortune_eval  → final report          (LLM ~30–90s)

每次 tools/call 都会一次性返回完整结果（OneShot）——没有 job_id、无需轮询。t4 有 30–90 秒的尾延迟，请将客户端工具调用超时设为 ≥ 120 秒。t3/t4 失败时，仅重发失败的那一步（复用前序输出），不要从 t1 重启。

# t1 — first step of the fortune chain (Universal REST)
curl -X POST https://fortunehub.lighttune.com.au/api/universal/fortune/bazi_basic_analysis \
  -H "x-api-key: bz_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_year": 1990, "birth_month": 1, "birth_day": 15,
    "birth_hour": 12, "birth_minute": 0, "gender": "male",
    "location": { "city_name": "Beijing" }
  }'