裁判文书 MCP 接入指南

一、接入信息

先验证连通

不用装任何东西，直接粘进终端：

curl https://mcp.wenshucha.com/mcp/health

# 预期返回
# {"service":"wenshucha-mcp","ok":true,"records":160291678}

二、三步接入

协议是标准 MCP（Streamable HTTP），任何支持 MCP 的客户端都能接。

{
  "mcpServers": {
    "wenshucha": {
      "type": "http",
      "url": "https://mcp.wenshucha.com/mcp",
      "headers": {
        "x-api-key": "wsc_demo_public"
      }
    }
  }
}

不用客户端，直接 curl 调

curl -X POST https://mcp.wenshucha.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: wsc_demo_public" \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{
      "name":"search_judgments",
      "arguments":{"q":"民间借贷 保证人","pageSize":2}
    }
  }'

三、四个工具

拉取工具列表不消耗额度，只有真正调用才计次。

四、检索方式说明（请务必读）

实测于 2026-08-24 全量语料。口语表述不是查不到，而是召回量和相关性都明显更差；繁体则是真的 0 条。

但在 MCP 场景下，这基本不需要你操心。因为调用方本身就是大模型——工具描述里已经写明了改写规则，模型会自动把「老板拖欠工资」改写成「拖欠劳动报酬」再检索，必要时用多组同义词分别查询后合并。

相比向量召回，这样做的好处是绝大多数结果（案号字段覆盖约 97.8%）能追溯到具体案号，不会出现「看起来相关、实际不是那个案子」的情况。做法律场景，可追溯比召回率更重要。

如果你的场景确实需要纯向量召回，可以针对特定语料单独做，请联系我们详谈。

五、数据口径

每次调用的返回里都带 _coverage 字段，说明本次结果基于多完整的数据。这是刻意做的——你不该在不知道数据缺了多少的情况下用它写结论。

三点如实说明

1. 本库无判决原文链接。溯源请用「案号 + 法院 + 裁判日期」三元组，拿案号可上中国裁判文书网自行核对。

2. 记录数 ≠ 案件数。同一案件可能有多条记录，案号也存在缺失、脏值与未统一格式，因此不使用原始案号基数宣称案件总数。

3. 查不到 ≠ 不存在。本库不是中国全部裁判文书。verify_case_number 返回 not_found 只代表本库没有。

六、免费额度

额度用完会返回明确提示，不会静默失败。需要更多额度、商用授权或私有化部署，见 定价 或直接联系我们。