Ancient Echoes

Ancient Echoes MCP

Ancient Echoes 将确定性的中国玄学计算作为远程 MCP 服务提供：八字（四柱）、紫微斗数、 奇门遁甲、七政四余、吠陀占星与西方占星、六爻、梅花、大六壬、 小六壬、太乙、历法与择日依据。

计算引擎运行在我们的服务器上。本仓库仅包含客户端技能和设置说明，因此任何支持 MCP 的客户端都能调用相同版本的工具。

你将获得

每个工具响应都包含 calculationCapability / calculationVersion，确保结果在不同版本间可复现。

已列入官方 MCP Registry，名称为 io.github.FlamesCN/ancient-echoes-mcp。 支持 MCP Apps 的宿主会将八字结果呈现为交互式命盘；其他宿主则会收到相同的结构化 JSON。

支持 OAuth 的连接器可以通过 https://www.ancientechoes.ai/.well-known/oauth-protected-resource 发现授权服务器，并使用标准 PKCE 流程连接。开发者仍可在 Authorization 标头中使用 Web API 密钥。

1. 获取 API 密钥

登录 https://www.ancientechoes.ai，然后打开 用户中心 → LingXi 设备：

• Web API 密钥（sk-…）：最适合 MCP 客户端。
• 设备令牌（lxd_…）：使用短代码配对机器；默认带有 mcp 权限范围，并且可以轮换或撤销，无需更改密码。

两种凭据都可访问 POST /api/v1/mcp 和 POST /api/v1/tools/:name。

2. 连接 MCP 客户端

端点：https://www.ancientechoes.ai/api/v1/mcp（Streamable HTTP）。 该服务支持协议版本 2026-07-28、2025-11-25、2025-06-18 和 2025-03-26。

{
  "mcpServers": {
    "ancient-echoes": {
      "url": "https://www.ancientechoes.ai/api/v1/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk-your-key"
      }
    }
  }
}

curl -sS https://www.ancientechoes.ai/api/v1/mcp \
  -H "Authorization: Bearer $ANCIENT_ECHOES_TOKEN" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

3. 调用工具

curl -sS https://www.ancientechoes.ai/api/v1/tools/bazi.calculate_chart \
  -H "Authorization: Bearer $ANCIENT_ECHOES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input_mode":"birth","year":1990,"month":6,"day":15,"hour":9,"minute":30,
       "is_male":true,"calendar_type":"solar","is_leap_month":false,
       "cast_time_source":"birth","timezone_id":"Asia/Shanghai",
       "split_zi_hour":true,"use_true_time":false,"apply_dst":false}'

重要规则：

• 请提供明确的民用时间、历法、时区，以及（使用真太阳时计算时的）坐标。服务绝不会使用自己的时钟或默认城市填补缺失字段。
• 如果你的套餐不包含相关功能，付费工具会返回 tool_entitlement_required。
• 配额：默认每位用户每天 200 次工具调用、每分钟 30 次调用。超出时会返回 429 和 tool_quota_exceeded。
• 当前所有工具均为只读。结果仅供人工参考，不构成医疗、法律、投资或人生决策建议。

自托管 stdio 桥接（Docker）

仅支持通过 stdio 使用 MCP 的客户端和注册表可以运行本仓库的桥接程序。它不包含计算引擎：initialize、ping 和 tools/list 会根据随附目录（由公开的 OpenAPI 文档生成，包含 38 个工具）在本地响应，而 tools/call 则会使用你自己的凭据转发到 POST /api/v1/tools/<name>。

docker build -t ancient-echoes-mcp .
printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | docker run --rm -i ancient-echoes-mcp

设置 ANCIENT_ECHOES_TOKEN（Web API Key 或设备令牌）以启用 tools/call；如果未设置，桥接程序会响应发现请求，并为执行请求返回明确的 isError 结果。ANCIENT_ECHOES_BASE_URL 和 ANCIENT_ECHOES_TIMEOUT_MS 可覆盖端点和超时时间。

技能

ancient-echoes-mcp/SKILL.md 会指导 Agent 如何发现工具、收集最低限度的必需参数、遵守权益限制，并在不编造预测的情况下报告结果。将它放入 Agent 的技能目录即可。

许可证

MIT。服务端引擎、知识库和数据集不属于本仓库。