# 法律之星 MCP 接入文档
> 法律之星 MCP 基于 Model Context Protocol（Streamable HTTP）。接入后可在 WorkBuddy、Trae、Claude 等 AI 客户端中，用自然语言直接检索法规、调取法条、核验引用。
## 法律之星 MCP
- **简介**：基于法律之星法规库，提供语义检索、法条精准查询、法规列表、批量语义检索、法条引用核验与批量法条查询共 6 个工具，支持 AI 客户端以自然语言调用。
- **端点地址**：`https://api.law-star.com/mcp/point`
- **接入方式**：Streamable HTTP（单端点 POST，`url` + `headers.Authorization`，客户端自动协商协议）

法律之星 MCP 服务基于法律之星专业法规数据库，为 AI 客户端提供 6 个法律检索与核验工具。服务采用 Streamable HTTP 传输协议，单端点统一入口，支持 Trae Code、Claude Code、Cursor、Dify、Cherry Studio 等主流 AI 客户端接入。

工具覆盖从语义检索到精准法条查询、从单条取文到批量核验的完整法律检索链路，适用于 AI 法律助手引用增强（RAG）、合规审查、法条引用幻觉检测等场景。
### 工具一览
- `law_semantic_search` 语义检索法律条文（单次 15 积分：单次最多返回 10 条结果）：语义检索法律条文，最多返回10条结果。单次调用只查询一组（一个语义检索文本），每次调用按单次计费。一次需检索多个不同问题时，请改用 law_article_recognition（批量语义检索，一次最多5组，按组数计费）。支持地域、时效性筛选和标题关键词过滤。
地域规则：每次只传一个地域组合（如"全国"或"北京"）；需要查询多个地方地域时，多次调用、每次传一个地域。当地方具体事项检索无结果时，建议先用 law_statute_list 按地域定位法规名称，再用 law_semantic_clause 按条号取条文全文。
- `law_semantic_clause` 按法律名称和条号取法条原文（单次 5 积分：已知法律名称 + 条号）：根据法律名称和条号，获取单条法条的完整内容。单次调用只查询一组（一个法律名称+一个条号），每次调用按单次计费。一次需查询多个法条时，请改用 law_law_reference（批量法条查询，一次最多5组，按组数计费）。支持传入校验时间查询历史时点生效的法条版本。
- `law_statute_list` 法规列表查询（单次 5 积分：返回前 10 条）：查询法规列表接口，通过关键词精确匹配法规，返回前10条结果。
- `law_article_recognition` 批量语义检索法条（单次 30 积分：按组数计费，一次最多 5 组）：根据自然语言描述批量识别相关法条内容，返回命中的法规条文片段及法规元信息。适用于识别文本中的法律条文出处，或批量通过语义查询相关法条。一次最多5组，只查一条也用数组。支持地域、时效性筛选和标题关键词过滤，timeliness为全局参数。
多地域规则：每项area只传一个地域组合（如"全国"或"北京"）；涉及多个地域时拆成多项（北京、上海各一项），系统按项独立返回。当地方具体事项检索无结果时，建议先用 law_statute_list 按地域定位法规名称，再用 law_semantic_clause 按条号取条文全文。
- `law_hallucination_check` 批量核验法条引用（单次 30 积分：按核验条数计费）：批量核验Agent生成的法条引用是否准确，结果按查询项分组返回。一次最多提交5组查询，只核验一条时也需使用数组。每个查询项采用双路线查询：①标题关键词+条款号精确查询——获取该法条的真实内容，可与生成内容比对；②标题关键词+语义文本检索——在该法规中语义匹配最接近的条文，帮助定位正确内容。适用于核验AI生成的法律回答中法条引用的准确性。
- `law_law_reference` 批量法条查询（单次 10 积分：按查询条数计费）：根据法律名称和条号，批量获取指定法条的完整内容。适用于查找文本中引用的多个法律条文场景。单个条款的查询请用 law_semantic_clause 工具。支持在一次调用中提交多个法条查询，结果按查询项分组返回。一次最多提交5组查询。支持传入校验时间查询历史时点生效的法条版本。checkTime为全局参数，对所有查询项统一生效。
### 工具与参数详解
#### 语义检索法律条文（`law_semantic_search`）
语义检索法律条文，最多返回10条结果。单次调用只查询一组（一个语义检索文本），每次调用按单次计费。一次需检索多个不同问题时，请改用 law_article_recognition（批量语义检索，一次最多5组，按组数计费）。支持地域、时效性筛选和标题关键词过滤。
地域规则：每次只传一个地域组合（如"全国"或"北京"）；需要查询多个地方地域时，多次调用、每次传一个地域。当地方具体事项检索无结果时，建议先用 law_statute_list 按地域定位法规名称，再用 law_semantic_clause 按条号取条文全文。
- **积分计价**：每次 `15` 积分（单次最多返回 10 条结果）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `text` | string | 是 | 语义检索文本。自然语言描述或检索关键词，如"受贿处罚""未签劳动合同双倍工资"。涉及罪名的统一提取为"XX罪"格式，涉及法律问题的保留完整法律概念，不自行改写或缩写用户使用的法律术语。 示例：`受贿罪量刑` |
| `area` | string | 是 | 法规适用地域（必填）。每次只传一个地域组合，如"全国"或"北京"；涉及多个地方地域时勿混传（如"北京 上海"），需多次调用分别查询。 示例：`全国` |
| `keyword` | string | 否 | 法规标题关键词（可选），用于在语义检索结果中按标题过滤。从用户输入中提取法规名称关键词（如"民法典""工伤保险条例"），多个用空格分隔，之间为AND关系。不能明确提取或不确定是否是法规名称时不传。 示例：`刑法` |
| `timeliness` | string | 否 | 是否只查现行有效法规，传"是"只返回现行有效法规，为空则查询全部法规。 示例：`是` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `title` | string | 所属法规标题 |
| `tiao` | string | 法条条号（如 第十七条） |
| `content` | string | 法条原文内容 |
| `depName` | string | 颁布部门或地域 |
| `issueDate` | string | 颁布日期 |
| `effectiveness` | string | 时效性 |
| `score` | number | 语义匹配得分 |
**请求示例**
```json
{
  "text": "受贿罪量刑",
  "area": "全国",
  "timeliness": "是"
}
```
**响应示例**
```json
{
  "code": 200,
  "data": [
    {
      "title": "中华人民共和国刑法",
      "tiao": "第三百八十三条",
      "content": "对犯贪污罪的，根据情节轻重，分别依照下列规定处罚……",
      "depName": "全国人民代表大会",
      "issueDate": "1979-07-01",
      "effectiveness": "现行有效",
      "score": 0.89
    }
  ]
}
```
**对话示例**
- 受贿罪怎么量刑
- 未签劳动合同双倍工资怎么算
- 公司股东出资瑕疵有什么法律规定
**使用场景**
- **办案前锁定适用法条**：在正式起草法律意见前，先用自然语言快速检索相关法条，明确请求权基础与责任边界。
- **解答客户咨询时即问即答**：客户描述事实后，直接在 AI 对话中检索支撑观点的法律依据，快速给出有据可依的答复。
- **对比不同地域的法规差异**：针对同一法律问题，分别按「全国」「北京」「上海」等地域检索，对比各地规定差异。
#### 按法律名称和条号取法条原文（`law_semantic_clause`）
根据法律名称和条号，获取单条法条的完整内容。单次调用只查询一组（一个法律名称+一个条号），每次调用按单次计费。一次需查询多个法条时，请改用 law_law_reference（批量法条查询，一次最多5组，按组数计费）。支持传入校验时间查询历史时点生效的法条版本。
- **积分计价**：每次 `5` 积分（已知法律名称 + 条号）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `text` | string | 是 | 法律名称（中文），如"刑法""民法典"。 示例：`刑法` |
| `tiao` | string | 是 | 法条条号（中文/数字），如"第十条""10"。 示例：`第十条` |
| `checkTime` | string | 否 | 校验时间：法律时效校验时间点，格式 yyyyMMdd（如 20230601）。传入后只返回在该日期正在生效实施的法规条款，自动过滤掉当时尚未施行或已失效的版本。不传则返回当前现行有效的版本。 示例：`20230601` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `title` | string | 完整法规标题 |
| `tiao` | string | 条号 |
| `content` | string | 法条原文 |
| `depName` | string | 颁布部门 |
| `issueDate` | string | 颁布日期 |
| `effectiveness` | string | 时效性 |
**请求示例**
```json
{
  "text": "刑法",
  "tiao": "第十条"
}
```
**响应示例**
```json
{
  "code": 200,
  "data": {
    "title": "中华人民共和国刑法",
    "tiao": "第十条",
    "content": "凡在中华人民共和国领域外犯本法规定之罪……",
    "depName": "全国人民代表大会",
    "issueDate": "1979-07-01",
    "effectiveness": "现行有效"
  }
}
```
**对话示例**
- 把刑法第十条的原文给我
- 查一下民法典第一千零七十九条的内容
- 我要看公司法第三十三条的具体规定
**使用场景**
- **撰写法律文书时核对原文**：起诉状、代理词等文书中引用法条前，先按法律名称 + 条号调取原文，避免凭记忆写错。
- **合同审查核对引用条款**：审查合同时核对引用的法条是否为最新版本、原文表述是否一致。
- **查询历史时点生效版本**：通过 checkTime 指定时间点，查询某部法律在特定历史时点正在生效的条文版本。
#### 法规列表查询（`law_statute_list`）
查询法规列表接口，通过关键词精确匹配法规，返回前10条结果。
- **积分计价**：每次 `5` 积分（返回前 10 条）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `title` | string | 是 | 关键词（必填）。支持完整名称或部分名称，如"民法典""反不正当竞争"。 示例：`民法典` |
| `depName` | string | 否 | 中文地域名称或部门名称，留空则查询全部。地域示例：北京市；部门示例：国务院、最高人民法院。 示例：`全国人民代表大会` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | string | 法规唯一 ID |
| `title` | string | 法规完整标题 |
| `depName` | string | 颁布部门或地域 |
| `issueDate` | string | 颁布日期 |
| `effectiveDate` | string | 施行日期 |
| `effectiveness` | string | 时效性 |
| `category` | string | 效力级别 |
**请求示例**
```json
{
  "title": "民法典",
  "depName": "全国人民代表大会"
}
```
**响应示例**
```json
{
  "code": 200,
  "data": [
    {
      "id": "ls_lawid_2020_001",
      "title": "中华人民共和国民法典",
      "depName": "全国人民代表大会",
      "issueDate": "2020-05-28",
      "effectiveDate": "2021-01-01",
      "effectiveness": "现行有效",
      "category": "法律"
    }
  ]
}
```
**对话示例**
- 查一下北京市的房屋租赁条例
- 国务院颁布的关于个人信息保护的法规有哪些
- 找一下反不正当竞争相关的法律
**使用场景**
- **新领域法规全景梳理**：接手新业务领域时，先按关键词检索该领域法规清单，快速建立法规地图。
- **确认法规最新修正版本**：检索法规标题，判断某部法规是否有最新修正或配套文件，避免引用旧版本。
- **按地域/部门精筛法规**：通过 depName 筛选某省、市或某部门发布的法规，聚焦管辖范围内的相关规定。
#### 批量语义检索法条（`law_article_recognition`）
根据自然语言描述批量识别相关法条内容，返回命中的法规条文片段及法规元信息。适用于识别文本中的法律条文出处，或批量通过语义查询相关法条。一次最多5组，只查一条也用数组。支持地域、时效性筛选和标题关键词过滤，timeliness为全局参数。
多地域规则：每项area只传一个地域组合（如"全国"或"北京"）；涉及多个地域时拆成多项（北京、上海各一项），系统按项独立返回。当地方具体事项检索无结果时，建议先用 law_statute_list 按地域定位法规名称，再用 law_semantic_clause 按条号取条文全文。
- **积分计价**：每次 `30` 积分（按组数计费，一次最多 5 组）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `queries` | array | 是 | 检索列表，一次最多5组。每项含 text（检索文本）、area（地域组合，每项一个）和可选 keyword（标题关键词）。 |
| `queries[].text` | string | 是 | 语义检索文本。自然语言描述或检索关键词，如"受贿处罚""未签劳动合同双倍工资"。 示例：`受贿罪量刑` |
| `queries[].area` | string | 是 | 地域组合，如"全国"或"北京"。涉及多个地域时拆分为多个查询项，勿混传。 示例：`全国` |
| `queries[].keyword` | string | 否 | 法规标题关键词，用于在语义检索结果中按标题过滤。多个用空格分隔，之间为AND关系。 示例：`刑法` |
| `timeliness` | string | 否 | 是否只查现行有效法规（全局参数），传"是"只返回现行有效法规，为空则查询全部法规。 示例：`是` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `queryIndex` | number | 对应 queries 数组的索引 |
| `results` | array | 该查询项的检索结果列表 |
| `results[].title` | string | 所属法规标题 |
| `results[].tiao` | string | 法条条号 |
| `results[].content` | string | 法条原文片段 |
| `results[].score` | number | 语义匹配得分 |
**请求示例**
```json
{
  "queries": [
    { "text": "受贿罪量刑", "area": "全国" },
    { "text": "诈骗罪怎么判", "area": "全国", "keyword": "刑法" }
  ],
  "timeliness": "是"
}
```
**响应示例**
```json
{
  "code": 200,
  "data": [
    {
      "queryIndex": 0,
      "results": [
        {
          "title": "中华人民共和国刑法",
          "tiao": "第三百八十三条",
          "content": "对犯贪污罪的，根据情节轻重，分别依照下列规定处罚……",
          "score": 0.89
        }
      ]
    },
    {
      "queryIndex": 1,
      "results": [
        {
          "title": "中华人民共和国刑法",
          "tiao": "第二百六十六条",
          "content": "诈骗公私财物，数额较大的，处三年以下有期徒刑……",
          "score": 0.92
        }
      ]
    }
  ]
}
```
**对话示例**
- 帮我查一下受贿罪和诈骗罪的量刑规定
- 未签劳动合同双倍工资和加班费的相关法规
- 民法典里关于违约责任和侵权责任的规定
**使用场景**
- **审查对方文书中的法条引用**：把对方答辩状、合同条款等文本提交给工具，自动识别其中引用的法条并返回原文用于核实。
- **批量识别合同条款法律依据**：一次提交多段合同条款，批量识别每条条款暗含的法律依据，提高合同审查效率。
- **核实 AI 生成回答的引用出处**：将 AI 生成的法律回答提交识别，确认其中引用的法条是否真实存在、出处是否准确。
#### 批量核验法条引用（`law_hallucination_check`）
批量核验Agent生成的法条引用是否准确，结果按查询项分组返回。一次最多提交5组查询，只核验一条时也需使用数组。每个查询项采用双路线查询：①标题关键词+条款号精确查询——获取该法条的真实内容，可与生成内容比对；②标题关键词+语义文本检索——在该法规中语义匹配最接近的条文，帮助定位正确内容。适用于核验AI生成的法律回答中法条引用的准确性。
- **积分计价**：每次 `30` 积分（按核验条数计费）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `queries` | array | 是 | 法条引用核验列表，一次最多5组。每项包含 keyword（法规标题关键词）、tiao（法条条号）和 text（待核验的Agent生成文本）。 |
| `queries[].keyword` | string | 是 | 法规标题关键词，用于定位具体法规。如"民法典""刑法""工伤保险条例"。 示例：`民法典` |
| `queries[].tiao` | string | 是 | 法条条号（中文/数字），如"第二条""10"。与keyword组合用于精确查询该法条的真实内容。 示例：`第二条` |
| `queries[].text` | string | 是 | 待核验的法条文本内容（Agent生成的法条正文）。与keyword组合用于语义检索该法规中最接近的条文。 示例：`民法调整平等主体的自然人之间的人身关系和财产关系` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `queryIndex` | number | 对应 queries 数组的索引 |
| `exactMatch` | object | 精确查询结果（标题关键词+条款号） |
| `exactMatch.title` | string | 法规标题 |
| `exactMatch.tiao` | string | 条号 |
| `exactMatch.content` | string | 真实法条原文 |
| `semanticMatch` | object | 语义检索结果（标题关键词+语义文本） |
| `semanticMatch.title` | string | 法规标题 |
| `semanticMatch.tiao` | string | 条号 |
| `semanticMatch.content` | string | 语义匹配的条文原文 |
| `semanticMatch.score` | number | 语义匹配得分 |
**请求示例**
```json
{
  "queries": [
    {
      "keyword": "民法典",
      "tiao": "第二条",
      "text": "民法调整平等主体的自然人之间的人身关系和财产关系"
    },
    {
      "keyword": "刑法",
      "tiao": "第二百六十四条",
      "text": "盗窃公私财物数额较大的处三年以下有期徒刑"
    }
  ]
}
```
**响应示例**
```json
{
  "code": 200,
  "data": [
    {
      "queryIndex": 0,
      "exactMatch": {
        "title": "中华人民共和国民法典",
        "tiao": "第二条",
        "content": "民法调整平等主体的自然人、法人和非法人组织之间的人身关系和财产关系。"
      },
      "semanticMatch": {
        "title": "中华人民共和国民法典",
        "tiao": "第二条",
        "content": "民法调整平等主体的自然人、法人和非法人组织之间的人身关系和财产关系。",
        "score": 0.95
      }
    }
  ]
}
```
**对话示例**
- 核验一下我写的民法典第二条引用是否准确
- 检查这段法律回答中引用的刑法第264条是否正确
- 验证我生成的法条内容有没有幻觉
**使用场景**
- **校验 AI 起草文书的法条引用**：AI 起草法律文书后，批量提交其中的法条引用进行核验，快速发现遗漏、篡改或编造。
- **核实 AI 咨询回答的准确性**：对 AI 法律咨询回答中的法条引用做精确 + 语义双路线核验，判断是否存在幻觉。
- **批量核验多条法条引用**：一次最多提交 5 组待核验内容，逐条比对真实原文与生成内容的差异。
#### 批量法条查询（`law_law_reference`）
根据法律名称和条号，批量获取指定法条的完整内容。适用于查找文本中引用的多个法律条文场景。单个条款的查询请用 law_semantic_clause 工具。支持在一次调用中提交多个法条查询，结果按查询项分组返回。一次最多提交5组查询。支持传入校验时间查询历史时点生效的法条版本。checkTime为全局参数，对所有查询项统一生效。
- **积分计价**：每次 `10` 积分（按查询条数计费）
**请求参数**
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | :-: | --- |
| `queries` | array | 是 | 法条查询列表，一次最多5组。每项包含 text（法律名称）和 tiao（法条条号）。 |
| `queries[].text` | string | 是 | 法律名称（中文），如"刑法""民法典"。 示例：`民法典` |
| `queries[].tiao` | string | 是 | 法条条号（中文/数字），如"第十条""10"。 示例：`第二条` |
| `checkTime` | string | 否 | 校验时间（全局参数）：法律时效校验时间点，格式 yyyyMMdd（如 20230601）。传入后只返回在该日期正在生效实施的法规条款。不传则返回当前现行有效的版本。 示例：`20230601` |
**响应字段**
| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `queryIndex` | number | 对应 queries 数组的索引 |
| `title` | string | 完整法规标题 |
| `tiao` | string | 条号 |
| `content` | string | 法条原文 |
| `depName` | string | 颁布部门 |
| `issueDate` | string | 颁布日期 |
| `effectiveness` | string | 时效性 |
**请求示例**
```json
{
  "queries": [
    { "text": "民法典", "tiao": "第二条" },
    { "text": "刑法", "tiao": "第三条" }
  ]
}
```
**响应示例**
```json
{
  "code": 200,
  "data": [
    {
      "queryIndex": 0,
      "title": "中华人民共和国民法典",
      "tiao": "第二条",
      "content": "民法调整平等主体的自然人、法人和非法人组织之间的人身关系和财产关系。",
      "depName": "全国人民代表大会",
      "issueDate": "2020-05-28",
      "effectiveness": "现行有效"
    },
    {
      "queryIndex": 1,
      "title": "中华人民共和国刑法",
      "tiao": "第三条",
      "content": "法律明文规定为犯罪行为的，依照法律定罪处刑；法律没有明文规定为犯罪行为的，不得定罪处刑。",
      "depName": "全国人民代表大会",
      "issueDate": "1979-07-01",
      "effectiveness": "现行有效"
    }
  ]
}
```
**对话示例**
- 帮我查一下民法典第二条和刑法第三条的原文
- 查一下劳动法第十九条和劳动合同法第十条
- 我要看民法典第143条和第146条的内容
**使用场景**
- **一次性调取多部法律条款**：撰写法律意见书时，把涉及的多部法律名称 + 条号一次性提交，批量获取原文。
- **合同审查批量核对多个法条**：审查合同引用的多个法条时批量调取原文，逐条比对合同表述是否与法律一致。
- **对比同一法律不同时期条文**：通过 checkTime 指定不同时间点，对比同一法律在不同时期的条文版本差异。
## 服务限制
- law_semantic_search 和 law_semantic_clause 单次调用只查询一组，每次按单次计费。
- law_article_recognition、law_hallucination_check、law_law_reference 一次最多提交 5 组查询，按组数计费。
- law_semantic_search 和 law_statute_list 单次返回最多 10 条结果。
- 地域参数 area 每次只传一个地域组合（如"全国"或"北京"），涉及多个地域时需多次调用或拆分为多个查询项。
- 需通过 Bearer Token 鉴权，API Key 在「控制台 - API Key 管理」中创建。
- 协议为 Streamable HTTP，单端点 POST，客户端自动协商协议。
- 接口调用按天限流：免费用户每日限 500 次，付费用户每日限 2000 次；按自然日统计，当日触发限流后将于次日 0 点自动恢复。
- 不得采取高频次、大规模的数据抓取行为，不得通过自动化脚本、爬虫或其他非正常 MCP 协议方式批量获取数据。平台有权根据调用频次、调用模式、数据获取量等指标综合判断是否存在异常调用行为。