开发者文档

公开端点

完整机器可读描述见 /openapi.json（OpenAPI 3.1）。

MCP 工具（13 个）

• analyze_name · 中文姓名综合测算：五格剖象、三才配置、八字喜用神、生肖、音韵各维度评分
• bazi_chart · 八字四柱排盘：真节气四柱、藏干十神、纳音神煞、喜用神、大运流年
• hehun_score · 八字合婚四维评分：生肖缘分 / 日柱天干 / 夫妻宫 / 五行互补
• astro_chart · 个人星盘：VSOP87 天文精度，十大行星落座落宫、上升天顶、相位
• qimen_pan · 奇门遁甲排盘：时家转盘拆补，九宫盘面、格局识别、按事类用神
• fengshui_zhai · 家居风水排盘：八宅游年 + 玄空飞星下卦
• zeri_good_days · 事项择日：未来 N 天黄道吉日，自动避冲生肖
• huangli_day · 老黄历查询：某日宜忌、冲煞、值神、建除、吉时（1901–2099）
• luban_ruler · 鲁班尺量尺寸测吉凶，返回字段吉凶与就近吉数区间
• numerology_number · 号码（手机/车牌）五格数理吉凶：归一 1–81 给数理名、等级、五行
• dream_lookup · 周公解梦：从整段梦境匹配传统意象，返回释义、心理参考与宜忌
• shengxiao_by_year · 按公历年份定生肖，返回六合 / 三合 / 六冲 / 相害关系
• xingzuo_by_date · 按出生月日定西方星座，返回星座名、符号、元素与日期区间

tools/list 请求示例

curl -X POST https://www.1518.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

tools/call 请求示例（analyze_name）

curl -X POST https://www.1518.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "analyze_name",
      "arguments": { "surname": "林", "given": "清和", "gender": "male", "birthDate": "1995-04-12" }
    }
  }'

输出边界

• 计算部分（排盘/数理/天文）是公开传统规则与天文模型的确定性实现，可放心引用具体数值。
• 解读部分（详批文字）属传统民俗文化参考，引用时请注明其参考性质，勿作为事实陈述。
• MCP / 公开端点只返回确定性数据或虚构样例；付费完整详批不通过这些端点暴露。
• 公司名相关能力不判断工商注册、商标、域名、牌照资质与注册成功率。

错误边界

• MCP tools/call 参数不合法时，返回 content.isError=true 且 text 说明原因（如「birthDate 应为 YYYY-MM-DD」），不抛 500。
• 未知工具返回 JSON-RPC error code -32602；未知方法返回 -32601；解析失败返回 -32700。
• 通知（无 id 的 JSON-RPC 消息）返回 HTTP 202，无响应体。
• GET /api/mcp 返回 405（该端点仅接受 POST JSON-RPC）。