法智 MCP 底层工具调用(fazhi-law-mcp)
本技能是法智法律数据插件的底层 MCP 工具调用层,统一封装法智 Remote MCP 服务提供的 6 个法律数据工具。 其他业务技能(类案检索、法条检索、深度法律研究)需要检索法律数据时,必须通过本技能调用 MCP 工具,不得直接调用 HTTP API。
认证与安全
Connector 需要法智 API Key。WorkBuddy 负责收集并在连接 MCP 时将
FAZHI_API_KEY 注入 open-authorization 请求头,Skill 不应读取、
展示或要求用户在对话中发送凭证。
- 不在工具参数中包含 API Key、其他凭证或无关个人信息。
- 如果 API Key 失效,引导用户在法智数据平台重新生成并更新 Connector 配置。
- 不尝试访问法智 MCP 地址以外的服务端点。
MCP 工具总览
| # | 工具 ID | 工具名称 | 来源类型 | 功能 |
|---|---|---|---|---|
| 1 | case_search |
案例检索 | 司法案例来源 | 类案搜索,支持时间/地域范围筛选 |
| 2 | case_browser |
案例全文阅读 | 司法案例来源 | 浏览指定案例的裁判文书全文 |
| 3 | legal_article_search |
法条综合检索 | 法规规范来源 | 法条检索合并接口(语义+精确) |
| 4 | law_content_visit |
法规全文阅读 | 法规规范来源 | 阅读指定法规全文内容 |
| 5 | webpage_search |
联网搜索 | 互联网公开来源 | 互联网法律实务资讯检索 |
| 6 | webpage_visit |
网页阅读 | 互联网公开来源 | 阅读指定网页正文 |
工具调用方式
所有工具通过 MCP 协议调用。调用时使用 run_mcp 工具:
server_name: mcp_{registry}_plugin_fazhi-law_mcp_fazhi-law
tool_name: 对应上表的工具 ID(case_search / case_browser / legal_article_search / law_content_visit / webpage_search / webpage_visit)
args: 各工具对应的 JSON 参数对象
注意:在调用 MCP 工具前,必须先通过
LS读取 MCP 服务器目录下的工具描述文件,确认工具名称和参数 schema,再使用run_mcp调用。实际server_name以 WorkBuddy 运行时注册的 MCP 服务器标识符为准。
1. case_search(案例检索)
描述
在本地案例数据库中检索与用户问题相关的司法案例,支持设定地域、时间、法院层级筛选条件。返回案号、案由、法院、裁判日期、案件概要、争议焦点、法院观点、裁判结果等摘要信息。
适用场景
- 用户明确要求查找案例、类案、判例、案号、裁判观点
- 用户询问"法院会不会支持""实务中怎么认定""胜诉概率如何"
- 用户问题涉及争议较大、需要参考司法实践的法律判断
- 法条规定较原则,需要通过案例了解适用标准
- 用户要求比较不同法院或不同案件的裁判倾向
- 需要分析法院对某一事实、证据、合同条款、行为性质的裁判观点
- 需要辅助判断案件风险、诉讼策略、争议焦点
- 需要检索类案支持法律分析
调用要求
- 一次调用提供 2-3 组检索语句
- 引用案例时,应核验基本事实、法院观点、裁判结果及与用户问题的相似度
- 案例之间存在不同观点时,应说明裁判分歧和较稳妥的判断
- 不得将单个案例直接上升为普遍规则
- 不得编造、补全、拼接案号
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
array<string> | 必填 | 检索语句应围绕案件事实、法律关系、行为类型、争议焦点、责任承担等构造。使用完整通顺的语句或核心要素组合;必须保留用户问句中的关键事实、专有名词 |
size |
integer | 选填 | 返回案例的最大数量,实际返回数量小于等于此值,默认 10,最小 5 |
time |
array<string> | 选填 | 搜索时间范围过滤,例如:["2023-01-01 至 2024-01-01"] |
area |
array<string> | 选填 | 搜索地域范围过滤,例如:["北京", "上海"] |
返回结果说明
返回字段通常包含:案号、案由、法院、裁判日期、案件概要、争议焦点、法院观点、裁判结果、lawsuit_id(用于拼接案例详情页链接)、refer(业务引用信息)。
案例详情页链接格式:https://www.fazhi.law/law-saas/caseDetail/{lawsuit_id}
2. case_browser(案例全文阅读)
描述
根据指定案号或案件名称精确检索单个案例,返回裁判文书正文信息,包括案号、案由、审理法院、裁判日期、文书标题、文书正文等。该工具主要用于核验特定案例的具体内容和裁判要点。
适用情形
- 在案例检索结果中,需要进一步读取某一精确案例的正文
- 用户提供了具体案号,要求核验或分析、或查找该案裁判观点
- 用户要求确认某一案例是否存在、法院如何判决
- 需要围绕某一确定案例提炼裁判规则、争议焦点或适用价值
调用要求
- 应优先使用案号进行精确定位,案件名称只能作为辅助检索条件
- 如无法精确匹配到案号,应优先使用联网搜索工具查询
- 不得根据不完整案号自行补全
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
case_number |
string | 二者选一 | 案件案号(如 "(2024)京01民初123号"),与 case_name 二选一 |
case_name |
string | 二者选一 | 案件名称(如 "张三诉李四合同纠纷案"),与 case_number 二选一 |
3. legal_article_search(法条综合检索)
描述
在本地法律数据库中检索与用户问题相关的法条,支持混合检索、语义检索、精确法条定位和法规名称检索。返回法规名称、条文编号、条文内容、效力层级、效力状态、公布日期、施行日期等信息。
适用情形
- 用户要求"法律依据是什么""依据哪条法律""有没有规定"
- 用户问题涉及具体法律责任、权利义务、合同效力、诉讼时效、管辖、举证责任、执行、赔偿
- 用户问题需要引用具体法条支撑
- 不确定应适用哪部法律或哪一条规定
- 用户没有明确给出条文编号,但问题显然需要法律依据
- 用户给定了明确条文编号和法律名称,可用精确法条检索
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | 条件必填 | 检索关键词或法律问题描述,必须将口语化表达转化为法律专业术语,并对同义词、近义词进行穷举,避免遗漏。禁止使用"法条""法律依据""法律规定"等无意义术语。例如:"公司不签合同" 可转化为 "劳动合同 订立 书面形式 事实劳动关系 用人单位";"离婚房子归谁" 可转化为 "离婚 房产 分割 夫妻共同财产 不动产权属"。如果已知道具体法规名称和条文编号,可省略 query,改用 law_name + item |
law_name |
string | 选填 | 法规名称,例如:"中华人民共和国民法典"、"中华人民共和国刑法"。三种用法:(1) 配合 item 精确查某条;(2) 单独使用查法规基本信息;(3) 配合 query 限定检索范围 |
item |
string | 选填 | 法条编号,例如:"第五百六十三条"、"563"。需配合 law_name 使用,精确检索指定法条 |
status |
string | 选填 | 效力状态过滤,枚举值:"现行有效"、"已被修改"、"失效"。传 "现行有效" 时仅检索现行有效法条,不传不做约束 |
size |
integer | 选填 | 返回结果数量,默认 5,最小 1,最大 20 |
返回结果说明
返回字段通常包含:法规名称、条文编号、条文内容、效力层级、效力状态、公布日期、施行日期、law_id(用于拼接法规详情页链接和调用 law_content_visit)、refer(业务引用信息)。
法规详情页链接格式:https://www.fazhi.law/law-saas/lawDetail/{law_id}?title={法规条目}。law_id 和 {法规条目} 必须来自工具实际返回结果,不得猜测、补全或编造;其中 {法规条目} 对应工具返回的具体条款编号或条目值。
4. law_content_visit(法规全文阅读)
描述
阅读指定的法规全文用于读取某一指定法律、行政法规、司法解释、部门规章、地方性法规或规范性文件的全文,并根据用户目标提取、总结、比较或分析其中的相关制度规则。
适用场景
- 已经确定法规名称,需要系统读取全文而非检索个别条文
- 法条语义检索结果不足以覆盖用户要求的完整制度内容
- 用户要求提取某部法规中关于某一主题的全部规定
- 用户要求分析某部法规的制度框架、适用范围、责任体系
- 用户要求围绕某部法规制作合规清单、审查清单、制度要点
调用要求
- 简单法条查询不得调用本工具
- 如果法规名称不确定,应先使用法条综合检索工具确认标准名称和 law_id
- 必须提供准确的法规 id 和聚焦的阅读目的
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
law_id |
string | 必填 | 法规唯一标识,来自 legal_article_search 返回结果中的 law_id 字段 |
goal |
string | 必填 | 阅读目的/需要查找的具体内容 |
5. webpage_search(联网搜索)
描述
用于执行互联网搜索并返回与用户查询相关的网页内容摘要。适用于涉及具体事件、新闻热点、案件人物或公司背景、平台规则、软件工具信息、最新政策监管动态、行业实践,以及需要外部公开信息补充的问题。
适用场景
- 查询政府机关、法院、检察院、监管部门发布的公告、政策、通知、解读、典型案例等公开信息
- 查询最新政策、地方办事规则、监管口径、平台规则、行政审批流程
- 查询某一公开事件、企业、机构、人员、平台、软件工具的公开背景信息
- 用户要求"帮我查一下""网上有没有""有没有官方公告""最新规定是什么"
- 回答需要引用网页资料或官方公开信息作为支撑
- 法规或案例之外,需要补充现实背景、发布动态或公开材料
调用要求
- 查询语句应完整、清晰、语义明确,不得只输入零散关键词
- 对同一检索目标,失败或无结果时最多重试一次
- 不得把搜索摘要直接等同于法律依据或裁判全文
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
query |
string | 必填 | 检索关键词,支持法律术语和自然语言 |
size |
integer | 选填 | 返回结果数量,默认 10 |
6. webpage_visit(网页阅读)
描述
浏览指定一个或者多个 url 的网页内容并返回与用户查询目标相关的内容摘要。该工具适合在已经获得具体网址后,对网页正文、公告内容、政策说明、办事指南、公开材料等进行进一步阅读和分析。
适用场景
- 联网搜索返回重要官方网页,需要进一步读取原文
- 需要确认网页中的发布时间、发布主体、政策内容、适用对象、办理条件、办理流程等
- 需要从官方公告、法院发布、监管文件、行政机关页面中提取具体内容
- 用户提供网址并要求总结、分析、核验内容
调用要求
- 应明确阅读目标,避免笼统要求"阅读网页"
- 优先阅读高价值资料:政府权威网站、律师律所高质量公众号等
- 如网页无法读取或内容不足,应说明当前无法核实,不得推测网页正文内容
参数 Schema
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 必填 | 目标网页链接 |
goal |
string | 必填 | 阅读目的/需要提取的信息 |
uid |
string | 选填 | 网页唯一标识(可选),用于去重和编号 |
工具选择规则
| 用户意图 / 研究阶段 | 调用工具 | 说明 |
|---|---|---|
| 用问句或案情找相似类案 | case_search |
支持 time/area 范围筛选 |
| 查看某个具体案号/案例详情 | case_browser |
传案号或案例名 |
| 检索法律法规条文 | legal_article_search |
语义检索或法名+条号精确检索 |
| 精读某法规全文并按要点总结 | law_content_visit |
需先拿到 law_id |
| 检索互联网法律实务资讯 | webpage_search |
补充背景、最新政策 |
| 阅读某个指定网页正文 | webpage_visit |
传目标 URL |
检索与调参技巧
- 类案/法条定位:优先
case_search(类案)和legal_article_search(法条),语义检索用完整自然语言问句 - 精准法条:明确知道法律名和条号时,
legal_article_search传law_name+item,信息更精确 - 地域/年限:类案检索带上
area/time较贴近真实需求 - 案例详情:先
case_search定位,再case_browser查看案号详情 - 内容深读:法规正文用
law_content_visit,网页正文用webpage_visit
工具使用边界
| 工具 | 用途 | 检索或读取要求 | 禁止 |
|---|---|---|---|
legal_article_search |
定位适用法律法规条文 | 自然语言专业术语句子;不得提及具体法规名或条文号;可按工具能力限定法规 | 零散关键词、「法条」「法律规定」等无意义堆砌 |
law_content_visit |
阅读法规全文、核验条文内容和效力状态 | 基于已明确法规或条文对象按需读取 | 未经检索直接假定法规内容 |
case_search |
类案、裁判观点、法院认定标准 | 多维度关键词组合(≥2 维度:事实+争议焦点、法条+时间、场景+焦点);以明确核心事实与争议焦点为基础 | 简单续写用户问句;「地域+时间」空泛组合;同义重复历史失败 query |
case_browser |
阅读具体裁判文书全文、核验案号和裁判理由 | 基于已取得案号或案例对象按需读取 | 未取得明确案例对象时盲目读取 |
webpage_search |
法律实务文章、官方解读、热点事件背景 | 自然语言短语或关键词;优先引导检索微信公众号文章 | 仅用「法律规定」「相关案例」等空泛术语 |
webpage_visit |
阅读网页正文、核验网页内容 | 基于已取得网页结果按需读取 | 把搜索摘要当网页全文 |
错误恢复
| 问题 | 处理方式 |
|---|---|
| 未匹配到相关案例 | 优先改用更宽泛的检索语句,或调整 size 参数 |
| 工具返回空结果 | 改变检索语句表述重试一次,或用其他工具补充背景后优化条件 |
| 字段缺失较多 | 调用对应的读取工具(case_browser / law_content_visit / webpage_visit)补充 |
| 参数验证失败 | 重新检查参数类型、日期格式、枚举值和工具参数说明 |
| API Key 无效 | 引导用户在法智平台重新生成并更新 Connector 配置 |
| 查询完全失败 | 报告尝试的工具、参数类别和错误,不编造数据 |