MCP · JSON-RPC 2.0

1518 MCP 文档

通过 POST /api/mcp 调用 1518 的确定性命理工具：姓名、八字、合婚、星盘、奇门、风水、择日、黄历、号码、解梦、生肖与星座。

工具清单

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

按出生月日定西方星座，返回星座名、符号、元素与日期区间

调用示例

初始化

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

列出工具

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

调用姓名测试

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

边界

MCP 工具免费、确定性、无副作用、无需鉴权。
MCP 只返回排盘、数理、匹配等可复核数据；不返回付费完整详批。
参数中可传姓名或生日，但 1518 不通过 MCP 建立个人档案，也不返回真实用户历史报告。
全部结果属传统民俗文化参考，不构成医疗、法律、投资、工商注册、商标、域名或牌照资质建议。

Agent Card 见 /.well-known/agent-card.json，OpenAPI 见 /openapi.json，开发者文档见 /developers。