← 返回首页
帮助文档
快速接入

小奇智算提供 MCP Streamable HTTP 协议接口，兼容 MCP 的 AI 客户端均可直接连接。

服务地址：https://www.xiaoqizhisuan.cn/mcp

认证方式：请求 Header 携带 API Key

测试APIKEY(限时)：xq_5434b532cb7ebf5566c26bf91db4c2e2

⚠️ 重要：必须设置 Accept: application/json, text/event-stream Header

x-api-key: xq_你的API密钥
Claude Desktop / Cursor / Windsurf 配置 
{
  "mcpServers": {
    "xiaoqi": {
      "url": "https://www.xiaoqizhisuan.cn/mcp",
      "headers": {
        "x-api-key": "xq_你的API密钥",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}
OpenClaw / Hermes / mcporter 配置 
{
  "mcpServers": {
    "xiaoqi": {
      "type": "streamable-http",
      "url": "https://www.xiaoqizhisuan.cn/mcp",
      "headers": {
        "x-api-key": "xq_你的API密钥",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}
通用 HTTP 调用（curl） 
# 1. 初始化
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "my-client", "version": "1.0"}
    }
  }'

# 2. 获取工具列表
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

# 3. 调用工具
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "bazi_dayun",
      "arguments": {
        "year": 1990, "month": 5, "day": 15, "hour": 8, "xingbie": "男"
      }
    }
  }'

下载 SKILL.md

工具定价
八字大运查询¥0.2 / 次
奇门排盘（JSON数据）¥0.5 / 次
奇门排盘(JSON)+HTML交互网页¥0.8 / 次
即时盘准备（含用神+分析思路+网页排盘+prompt）¥1.0 / 次
终身盘准备（含八字大运+用神+分析思路+网页排盘+prompt）¥1.2 / 次
即时局完整解盘（网页排盘+用神+分析思路+prompt+LLM解盘）¥1.5 / 次
终身局完整解盘（八字大运+网页排盘+用神+分析思路+prompt+LLM解盘）¥2.0 / 次
工具详细说明
1. bazi_dayun — 八字大运查询 ¥0.2

输入出生时间，返回八字四柱和大运信息。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bazi_dayun","arguments":{"year":1990,"month":5,"day":15,"hour":8,"xingbie":"男"}}}'
参数类型必填说明
yearinteger必填出生年（公历）
monthinteger必填出生月
dayinteger必填出生日
hourinteger必填出生时（0-23）
xingbiestring必填性别（"男"/"女"）

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • bazi — 八字四柱对象（年、月、日、时干支）
  • dayun — 大运数组（每步大运的天干地支）
  • error — 错误信息（失败时返回）
2. qimen_paipan — 奇门排盘（JSON数据） ¥0.5

输入时间，返回完整奇门九宫排盘 JSON 数据（天盘、地盘、八门、九星、八神、格局等）。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_paipan","arguments":{"year":2026,"month":4,"day":28,"hour":14,"minute":30}}}'
参数类型必填默认说明
yearinteger必填年
monthinteger必填月
dayinteger必填日
hourinteger必填时（0-23）
minuteinteger选填0分
numberinteger选填1排盘方法（1=拆补法，2=置润法，默认1）

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • 数据 — 奇门排盘完整数据（九宫、八门、九星、八神、格局等）
  • error — 错误信息（失败时返回）
3. qimen_paipan_image — 奇门排盘+HTML网页图 ¥0.8

奇门排盘(JSON)+HTML交互网页。排盘数据同 qimen_paipan，额外生成可渲染的 HTML 九宫格网页，返回可访问的 html_url 链接。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_paipan_image","arguments":{"year":2026,"month":4,"day":28,"hour":14,"minute":30}}}'

参数（必填）：

参数类型必填说明
yearinteger必填年
monthinteger必填月
dayinteger必填日
hourinteger必填时（0-23）
minuteinteger选填分，默认0
numberinteger选填排盘方法（1=拆补法，2=置润法），默认1

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • 数据 — 奇门排盘数据
  • html_url — 可访问的网页链接
  • error — 错误信息（失败时返回）
4. qimen_jiepan — 即时盘准备 ¥1.0

返回排盘数据 + 知识库用神检索 + 解盘分析思路 + 供 LLM 使用的 system_prompt 和 user_prompt。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_jiepan","arguments":{"year":2026,"month":4,"day":28,"hour":14,"question":"事业运势"}}}'
参数类型必填默认说明
year/month/day/hourinteger必填起盘时间
minuteinteger选填0分
numberinteger选填1排盘方法（1=拆补法，2=置润法）
questionstring必填"请分析此局"所问事项

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • html_url — 可访问的排盘网页链接
  • system_prompt — 给 LLM 的系统提示词（含用神和分析思路）
  • user_prompt — 给 LLM 的用户提示词（含问题+排盘数据）
  • error — 错误信息（失败时返回）

调用方可将这两个 prompt 喂给自己的 LLM 获取解盘结果。

5. qimen_jiepan_lifetime — 终身盘准备 ¥1.2

终身盘准备（含八字大运+用神+分析思路+网页排盘+prompt）。与即时盘准备类似，但额外包含八字大运数据，适合分析终身命运。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_jiepan_lifetime","arguments":{"year":1990,"month":5,"day":15,"hour":8,"xingbie":"男","question":"终身运势"}}}'

参数：

参数类型必填说明
yearinteger必填年
monthinteger必填月
dayinteger必填日
hourinteger必填时（0-23）
xingbiestring必填性别（"男"/"女"）
minuteinteger选填分，默认0
numberinteger选填排盘方法（1=拆补法，2=置润法），默认1
questionstring必填所问事项

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • bazi — 八字四柱对象（年、月、日、时干支）
  • dayun — 大运数组（每步大运的天干地支）
  • html_url — 可访问的排盘网页链接
  • system_prompt — 给 LLM 的系统提示词（含用神和分析思路）
  • user_prompt — 给 LLM 的用户提示词（含问题+排盘数据）
  • error — 错误信息（失败时返回）

调用方可将这两个 prompt 喂给自己的 LLM 获取解盘结果。

6. qimen_full — 即时局完整解盘 ¥1.5

即时局完整解盘（网页排盘+用神+分析思路+prompt+LLM解盘）。一站式服务：排盘 + HTML 网页 + LLM 解盘结果。无需调用方自己对接 LLM。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_full","arguments":{"year":2026,"month":4,"day":28,"hour":14,"question":"事业运势"}}}'

参数（必填）：

参数类型必填说明
yearinteger必填年
monthinteger必填月
dayinteger必填日
hourinteger必填时（0-23）
minuteinteger选填分，默认0
numberinteger选填排盘方法（1=拆补法，2=置润法），默认1
questionstring必填所问事项

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • html_url — 可访问的网页链接
  • system_prompt — 给 LLM 的系统提示词（含用神和分析思路）
  • user_prompt — 给 LLM 的用户提示词（含问题+排盘数据）
  • jiepan_result — LLM 解盘文字结果（服务端调用模型生成，null 则服务端未配置LLM）
  • error — 错误信息（失败时返回）
7. qimen_full_lifetime — 终身局完整解盘 ¥2.0

终身局完整解盘（八字大运+网页排盘+用神+分析思路+prompt+LLM解盘）。最完整的服务：八字大运 + 排盘 + HTML 网页 + LLM 终身局解盘。

→ 调用示例

直接 HTTP 请求 
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: xq_你的API密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"qimen_full_lifetime","arguments":{"year":1990,"month":5,"day":15,"hour":8,"xingbie":"男","question":"终身运势"}}}'

参数（必填）：

参数类型必填说明
yearinteger必填年
monthinteger必填月
dayinteger必填日
hourinteger必填时（0-23）
xingbiestring必填性别（"男"/"女"）
minuteinteger选填分，默认0
numberinteger选填排盘方法（1=拆补法，2=置润法），默认1
questionstring必填所问事项

返回字段：

  • success — true 表示成功
  • cost — 本次消费金额（元）
  • balance — 剩余余额（元）
  • bazi — 八字四柱对象（年、月、日、时干支）
  • dayun — 大运数组（每步大运的天干地支）
  • html_url — 可访问的网页链接
  • system_prompt — 给 LLM 的系统提示词（含用神和分析思路）
  • user_prompt — 给 LLM 的用户提示词（含问题+排盘数据）
  • jiepan_result — LLM 终身局解盘文字结果（含八字大运分析+奇门盘验证，null 则服务端未配置LLM）
  • error — 错误信息（失败时返回）
API Key 获取

联系 小奇智算 获取 API Key，格式为 xq_ 开头的32位字符串。

支持微信扫码充值，访问 API控制台 使用网页充值。

错误码
401缺少或无效 API Key
402余额不足
403API Key 已禁用
500服务器内部错误