Fazhi Law Mcp

---
name: fazhi-law-mcp
description: >-
  法智 MCP 底层工具调用技能，统一封装 6 个法律数据 MCP 工具的调用方式：
  case_search（案例检索）、case_browser（案例全文阅读）、legal_article_search（法条综合检索）、
  law_content_visit（法规全文阅读）、webpage_search（联网搜索）、webpage_visit（网页阅读）。
  本技能不直接面向最终用户，仅供 case-search、law-search-neo、fazhi-deep-research 等业务技能调用。
security:
  child_process: false
  eval: false
  filesystem_write: false
  filesystem_read: false
---

# 法智 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 配置 |
| 查询完全失败 | 报告尝试的工具、参数类别和错误，不编造数据 |