给 AI 客户端接上真实数据集

一、有哪些工具可以直接调

AI 客户端连上后会自动发现下面这 4 个工具，按需调用、只读返回：

• history_of_today · 历史上的今天：按日期（MMDD）返回当天发生过的历史事件；不传日期就取今天。适合资讯类 Bot 的「今日看点」。
• history_list · 历史事件分页：分页浏览全量历史事件库，可带关键字过滤。
• dream_search · 周公解梦：按关键字检索解梦条目（对标题正则匹配），分页返回。
• color_list · 中国传统色彩：分页获取传统色名称与色值，可按颜色名过滤。适合设计类助手取色。

数据之外还有一组 REST 数据集（同一把 Key）： /api/v1/front/documents/ 提供文档解析结果——文件名、多级分类、AI 摘要与元信息， 对外不回传原始正文。返回字段的宽度随账号档位自动裁剪，档位越高字段越全。

二、两段配置，接入只要一分钟

先注册并领一把免费 Key（提交即发放，明文只回显一次，存好）， 再把下面的配置贴进你的 AI 客户端。把 你的 API Key 换成领到的 Key 即可。

Cursor / 通用远程 MCP（mcp.json）

{
  "mcpServers": {
    "xuliming-data": {
      "url": "https://api.xuyiheng.com/api/v1/mcp",
      "headers": { "x-api-key": "你的 API Key" }
    }
  }
}

Claude Desktop（经 mcp-remote 代理远程端点）

{
  "mcpServers": {
    "xuliming-data": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.xuyiheng.com/api/v1/mcp", "--header", "x-api-key:你的 API Key"]
    }
  }
}

先探一下通不通（curl）

curl -X POST https://api.xuyiheng.com/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: 你的 API Key" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

无 Key 返回 401，超配额返回 429；端点信息（含工具清单）也可以直接 GET /api/v1/mcp 查看。

三、免费领 Key，三步走通

• 1 · 注册：在开发者门户建一个账号（用户名 + ≥8 位密码），无需资质材料。
• 2 · 申请即发放：提交 Key 申请后自动通过，明文 Key 随响应一次性返回——页面刷新就看不到了，当场存好。
• 3 · 粘贴配置开用：把 Key 填进上面任意一段配置，AI 客户端立即可用；REST 调用同样吃这把 Key。

去开发者门户领 Key →

四、免费够用，档位更宽

免费档给的是够用的每日配额 + 核心字段。当你把数据接到生产场景里， 通常缺的是更高配额和更全的返回字段——这两样都在账号档位里， 在开发者门户「我的密钥」可对已领取的 Key 直接自助升级（微信内一键支付，PC 扫码）， 升档即时生效、不需要重新申请 Key。

了解档位与升级 →

本页不挂收款入口；价格与结算均在开发者门户内完成。

五、常见问题

MCP 是什么？和普通 API 有什么区别？

MCP（Model Context Protocol）是给 AI 客户端用的开放协议：Claude / Cursor 等支持 MCP 的客户端能自动发现端点上的工具列表并直接调用，不需要你手写 API 对接代码。底层仍是同一套 REST 数据与同一个 x-api-key，鉴权与配额完全复用。

使用要收费吗？

本期免费接入：注册开发者账号后提交申请即自动发放免费 Key（提交即发放，无需人工审批）。免费版有每日调用配额；更高配额与更全的返回字段随账号档位自动生效，可在开发者门户自助升级。

免费 Key 安全吗？会不会泄漏？

明文 Key 只在申请成功那一次返回，之后列表里只见脱敏值；支持随时轮换与停用。调用时 Key 只走请求头 x-api-key，不接受 URL 参数，避免落进日志与缓存。

不在 Claude / Cursor 里，能用这些数据吗？

能。同一把 Key 也能按 REST 方式调用：历史上的今天 / 周公解梦 / 中国传统色彩三个数据集端点，加上文档解析数据集（文件名、分类、AI 摘要与元信息，不含原文），全部走 x-api-key 请求头。

数据集为公版内容或经 AI 处理的结构化结果；若你看到页面上的广告位或推荐位，那是站点自身的运营组件，与本数据服务无关。