文书查 / SinoVerdict MCP Server

把 110 万+ 结构化的中国劳动争议判决接进你的 AI 助手 / Agent —— Codex、Claude Desktop、Cursor、Claude Code,或任何支持 MCP 的客户端。

Beta 阶段限劳动争议数据集;正式版开放 1.5 亿份全量裁判文书 + 法规库。申请试用 key:邮件 chenjiaxin@wenshucha.com 或电话 131-6872-7779,一个工作日内回复。

提供的 Tool

两套能力:① 全案由通用检索(120万+ 判决,覆盖 1200+ 案由);② 劳动争议专项(8万结构化判决 + 金额量化)。

Tool	用途
`browse_full_corpus`	全量库浏览(1.3亿+ 真全量,非样本) —— 直连完整裁判文书库,按省份(+案由)左前缀浏览最新判决,返回标题/案号/案由/法院/省份/审判程序/裁判日期 + 原文链接。按省份浏览快;加案由筛选当前较慢(全文检索/聚合统计开放中)
`search_judgments`	全案由关键词检索(120万样本) —— 按关键词 + 案由/省份/法院/年份过滤,返回标题/法院/案由/日期/案号 + 原文链接
`search_cases`	劳动争议专项(8万样本) —— 案情文本 + 结构化过滤(省份/案由/解雇原因/工龄/年份)→ Top 20 类案 + 金额分位(p25/中位/p75)+ 关键裁判因素
`get_case`	依 doc_id 取单条判决详情
`case_stats`	劳动争议按省份 / 解雇原因 / 工龄分桶切片聚合(金额分位 + 平均月薪)

全量 vs 样本:browse_full_corpus 打的是 1.3 亿+ 完整库(浏览式);search_judgments/search_cases 是带关键词/量化检索的样本集。全量库的全文检索与大数据聚合统计正在开放中。

数据规模:试用为全案由样本 120万+ 与劳动 8万;正式版开放全量 1.4 亿 + 全文检索。

每条判决均含中国裁判文书网原文链接(source_url),结果可溯源、可呈堂。

安装(三步)

# 1. 拉代码
git clone https://github.com/jack0752168/wenshucha-mcp.git ~/wenshucha-mcp

# 2. 装依赖(只需一次)
cd ~/wenshucha-mcp && npm install

# 3. 先用 curl 验证 key 通(把 <KEY> 换成你的试用 key)
curl -H "X-API-Key: <KEY>" "https://tob.wenshucha.com/api/v1/health"
# 返回 {"ok":true,...} 即 key 有效

接入 Codex(OpenAI Codex CLI)

方式一:命令行一行加(推荐)

codex mcp add wenshucha \
  --env WENSHUCHA_API_KEY=<你的试用KEY> \
  --env WENSHUCHA_API_BASE=https://tob.wenshucha.com \
  -- node $HOME/wenshucha-mcp/bin/wenshucha-mcp.mjs

加完确认:

codex mcp list          # 应能看到 wenshucha
codex mcp get wenshucha

方式二:手动写 `~/.codex/config.toml`

[mcp_servers.wenshucha]
command = "node"
args = ["/Users/<你>/wenshucha-mcp/bin/wenshucha-mcp.mjs"]

[mcp_servers.wenshucha.env]
WENSHUCHA_API_KEY = "<你的试用KEY>"
WENSHUCHA_API_BASE = "https://tob.wenshucha.com"

在 Codex 里怎么用

启动 codex,直接用自然语言让它调,例如:

用 wenshucha 检索「经济性裁员工龄7年拒签合同」在广东省的类案,给我金额区间和胜诉率。

Codex 会自动调用 search_cases,拿回 Top 20 类案 + 量化统计 + 裁判文书网原文链接。

接入 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "wenshucha": {
      "command": "node",
      "args": ["/Users/<你>/wenshucha-mcp/bin/wenshucha-mcp.mjs"],
      "env": {
        "WENSHUCHA_API_KEY": "<你的试用KEY>",
        "WENSHUCHA_API_BASE": "https://tob.wenshucha.com"
      }
    }
  }
}

重启 Claude Desktop 后,模型侧自动看到 search_cases / get_case / case_stats 三个 tool。

接入 Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "wenshucha": {
      "command": "node",
      "args": ["/Users/<你>/wenshucha-mcp/bin/wenshucha-mcp.mjs"],
      "env": {
        "WENSHUCHA_API_KEY": "<你的试用KEY>",
        "WENSHUCHA_API_BASE": "https://tob.wenshucha.com"
      }
    }
  }
}

接入 Claude Code

claude mcp add wenshucha \
  --env WENSHUCHA_API_KEY=<你的试用KEY> \
  --env WENSHUCHA_API_BASE=https://tob.wenshucha.com \
  -- node /Users/<你>/wenshucha-mcp/bin/wenshucha-mcp.mjs

环境变量

变量	默认	说明
`WENSHUCHA_API_KEY`	(无)	必填,试用 key
`WENSHUCHA_API_BASE`	`https://tob.wenshucha.com`	选填,换 staging 时用

试用限制

60 次/分钟 per key
Beta 阶段限「劳动争议」数据集
Trial key 90 天有效,正式合作后换长期 key

联络

文书查 · 深圳星谱网络科技有限公司商务电话:131-6872-7779 邮箱:chenjiaxin@wenshucha.com 官网:https://www.wenshucha.com

SinoVerdict MCP Server

文书查 / SinoVerdict MCP Server

提供的 Tool

安装(三步)

接入 Codex(OpenAI Codex CLI)

方式一:命令行一行加(推荐)

方式二:手动写 `~/.codex/config.toml`

在 Codex 里怎么用

接入 Claude Desktop

接入 Cursor

接入 Claude Code

环境变量

试用限制

联络

Latest Blog Posts

MCP directory API

文书查 / SinoVerdict MCP Server

提供的 Tool

安装(三步)

接入 Codex(OpenAI Codex CLI)

方式一:命令行一行加(推荐)

方式二:手动写 ~/.codex/config.toml

在 Codex 里怎么用

接入 Claude Desktop

接入 Cursor

接入 Claude Code

环境变量

试用限制

联络

Latest Blog Posts

MCP directory API

方式二:手动写 `~/.codex/config.toml`