裁判文书 MCP 接入指南

一、接入信息

先验证连通

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

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

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

二、三步接入

远程端点使用 MCP Streamable HTTP。各客户端的配置格式不同，请只复制自己使用的那一段。

Claude Desktop · Cursor · Claude Code · 配置报错排查

Claude Desktop 桌面版

先安装 Node.js LTS（推荐 22 或更新版本），在终端确认 node --version 和 npx --version 都能运行。打开 Settings → Developer → Edit Config：macOS 文件是 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 是 %APPDATA%\Claude\claude_desktop_config.json。

这份本机配置使用 command/args，通过 mcp-remote 转接到我们的远程服务。不要把下面 Cursor / Claude Code 的 HTTP 配置粘到这里。如果已有其他 MCP 服务，只在 mcpServers 里增加 wenshucha，保留其他配置。

macOS：下载配置 JSON

{
  "mcpServers": {
    "wenshucha": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.wenshucha.com/mcp",
        "--transport", "http-only",
        "--header", "x-api-key:wsc_demo_public"
      ]
    }
  }
}

Windows（通过 cmd /c 启动 npx）：下载配置 JSON

{
  "mcpServers": {
    "wenshucha": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y", "mcp-remote",
        "https://mcp.wenshucha.com/mcp",
        "--transport", "http-only",
        "--header", "x-api-key:wsc_demo_public"
      ]
    }
  }
}

保存后完全退出并重新打开 Claude Desktop。首次连接会下载 mcp-remote，请允许一段准备时间；如果公司网络不能访问 npm，请按下面的错误说明排查。

Cursor

保存到项目的 .cursor/mcp.json 或全局 ~/.cursor/mcp.json。无需安装 mcp-remote。下载配置 JSON

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

Claude Code

在终端执行以下命令（只需一次），然后在 Claude Code 里用 /mcp 查看连接状态：

claude mcp add --transport http wenshucha https://mcp.wenshucha.com/mcp --header "x-api-key: wsc_demo_public"

或者保存以下配置到项目根目录 .mcp.json（首次加载按客户端提示信任项目服务）。下载配置 JSON

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

配置报错怎么排查

配置依据：Claude Desktop 本机配置 · mcp-remote 转接说明 · Cursor 官方文档 · Claude Code 官方文档

不用客户端，直接 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 只代表本库没有。

六、额度与档位

额度用完会返回明确提示（含开通方式），不会静默失败。开通任何档位都是加微信 131-6872-7779（备注「MCP」），当场发 Key、不用重启。完整价目见 定价页。