@realakagi/lawmcp 0.5.4 → 0.6.0

package/README.md

@@ -6,7 +6,7 @@ LawMCP 是面向律师、法务和法律研究人员的本地运行工具（MCP
 
 接入后，您可以直接用自然语言向 AI 助手提出检索需求：先找相似案例，再打开详情，继续追问法院观点、争议焦点、裁判结果或相关法规依据。
 
-目前可接入 **Claude Code**、**Kimi Code**、**Codex** 以及其他支持 stdio MCP 的 AI 客户端。LawMCP 已内置 **Claude Code / Kimi Code** 一键配置命令；其他客户端可手动添加 MCP 配置。
+目前可接入 **Claude Code**、**Kimi Code**、**Codex** 以及其他支持 stdio MCP 的 AI 客户端。LawMCP 已内置 **Claude Code / Kimi Code / Codex** 一键配置命令；其他客户端可手动添加 MCP 配置。
 
 [联系试用](mailto:tend_stretch_9r@icloud.com)
 
@@ -18,16 +18,18 @@ LawMCP 更适合把 AI 当成“会调用检索工具的研究助理”，而不
 
 | 工作场景 | 您可以这样问 | LawMCP 会做什么 |
 | --- | --- | --- |
-| 类案初筛 | “帮我检索近三年北京法院关于竞业限制补偿金的案例。” | 调用 AlphaLawyer 案例检索，返回标题、法院、案号、裁判日期和摘要线索。 |
-| 案例细读 | “打开第 3 个案例，看看法院怎么认定违约金过高。” | 根据检索结果读取案例详情，便于继续追问裁判观点和事实认定。 |
+| 类案初筛 | “帮我检索近三年北京法院关于竞业限制补偿金的案例。” | 调用 AlphaLawyer 案例检索，返回标题、法院、案号、裁判日期和摘要线索。 |
+| 多案例观点对比 | “先找钢材加价款相关案例，只看每个案例的法院认为。” | 只提取检索结果里的“法院认为”内容，减少一次查看多个案例时的上下文占用。 |
+| 案例细读 | “打开第 3 个案例，看看法院怎么认定违约金过高。” | 根据检索结果读取案例详情，便于继续追问裁判观点和事实认定。 |
 | 精准组合检索 | “排除保险公司，只看管理人责任纠纷中一审全部或部分支持的案例。” | 使用高级条件组合检索，适合更精确的类案研究。 |
 | 法规定位 | “查一下现行有效的民事诉讼法相关法规。” | 检索中国大陆法规，并可继续查看法规详情。 |
 | 长法规找条文 | “在民法典里找和抵押预告登记有关的命中条文。” | 只返回法规内命中的相关条文，减少整部法规带来的阅读噪音。 |
 
 常见使用方式：
 
-- 写诉状、答辩状、代理词、法律意见书前，先让 AI 拉取候选案例。
-- 做类案检索时，让 AI 围绕“案由、法院、裁判结果、争议焦点”继续追问。
+- 写诉状、答辩状、代理词、法律意见书前，先让 AI 拉取候选案例。
+- 一次比较多个候选案例时，先看“法院认为”，有价值时再打开完整详情。
+- 做类案检索时，让 AI 围绕“案由、法院、裁判结果、争议焦点”继续追问。
 - 需要在同一轮对话里同时查看案例和法规，减少在数据库、文档和聊天窗口之间切换。
 - 对 AI 生成的法律分析保持谨慎，让关键结论尽量回到可检索的案例或法规文本上。
 
@@ -158,17 +160,25 @@ npx -y @realakagi/lawmcp setup claude
 npx -y @realakagi/lawmcp setup kimi
 ```
 
-如果两者都要配置：
+如果您使用 **Codex**：
+
+```bash
+npx -y @realakagi/lawmcp setup codex
+```
+
+该命令会优先调用 Codex CLI；如果本机只有 Codex Desktop、没有可用的 `codex` 终端命令，LawMCP 会直接写入 Codex 的 `~/.codex/config.toml` 配置文件，并显式设置 `enabled = true`。
+
+如果已安装多个客户端，也可以一次性配置全部内置目标：
 
 ```bash
 npx -y @realakagi/lawmcp setup all
 ```
 
-若本步失败，请确认对应客户端已经安装，且终端里能执行 `claude` 或 `kimi` 命令。
+若 Claude Code 或 Kimi Code 配置失败，请确认对应客户端已经安装，且终端里能执行 `claude` 或 `kimi` 命令。Codex Desktop 不要求终端里必须能执行 `codex`。
 
-### Codex 或其他 MCP 客户端
+### 其他 MCP 客户端
 
-Codex 或其他支持 stdio MCP 的 AI 工具，可按对应客户端文档手动添加。常见配置形态如下：
+其他支持 stdio MCP、但未内置一键配置命令的 AI 工具，可按对应客户端文档手动添加。常见配置形态如下：
 
 ```json
 {
@@ -201,19 +211,23 @@ npx -y @realakagi/lawmcp doctor
 帮我检索北京法院近三年关于竞业限制补偿金的案例，优先看劳动争议案件。
 ```
 
-```text
-打开第 2 个案例，帮我归纳法院支持或不支持违约金的理由。
-```
-
-```text
-检索现行有效的民事诉讼法相关法规，并列出与管辖权异议有关的条文线索。
-```
+```text
+打开第 2 个案例，帮我归纳法院支持或不支持违约金的理由。
+```
+
+```text
+先检索钢材加价款相关案例，每条只返回法院认为，暂时不要展开完整详情。
+```
+
+```text
+检索现行有效的民事诉讼法相关法规，并列出与管辖权异议有关的条文线索。
+```
 
 ```text
 找管理人责任纠纷中一审全部或部分支持的案例，排除保险公司相关案件。
 ```
 
-不同 AI 客户端展示 MCP 工具的方式不同。默认服务名通常是 `lawmcp`；如果客户端需要您手动选择工具，请选择 LawMCP 提供的案例检索、案例详情、法规检索或法规详情能力。
+不同 AI 客户端展示 MCP 工具的方式不同。默认服务名通常是 `lawmcp`；如果客户端需要您手动选择工具，请选择 LawMCP 提供的案例检索、案例法院认为、案例详情、法规检索或法规详情能力。
 
 ## 安全提醒
 
@@ -245,10 +259,6 @@ LawMCP 授权用于校验您是否有权使用 LawMCP。AlphaLawyer 登录态用
 
 不会上传到 LawMCP 授权服务器。LawMCP 通过 stdio 在本机运行，AlphaLawyer 登录态保存在您的用户目录。授权服务器只处理 LawMCP 激活、续期和设备授权，不接收 AlphaLawyer Token。
 
-### 可以在 Codex 里使用吗？
-
-可以，只要 Codex 或其他 AI 工具支持 stdio MCP。当前 LawMCP 没有为 Codex 内置一键配置命令，请按“Codex 或其他 MCP 客户端”添加。
-
 ### 为什么只说中国大陆法规？
 
 当前法规检索接入的是 AlphaLawyer 的“中国大陆法规”接口。国际条约、港澳台法规、外国法规使用另一组接口，暂不在当前版本支持范围内。
@@ -262,9 +272,10 @@ LawMCP 授权用于校验您是否有权使用 LawMCP。AlphaLawyer 登录态用
 
 下面内容主要给技术同事、运维同事或需要手动调试 MCP 的用户查看。普通使用时不需要记住这些工具名和参数。
 
-- `search_cases`：按一个或多个关键词检索案例，支持分页与一次多页。
-- `advanced_search_cases`：按 AlphaLawyer 查询表达式检索案例，适合字段组合、层级条件和排除词。
-- `get_case_detail`：根据检索结果里的案例编号 `jid` 查看详情。
+- `search_cases`：按一个或多个关键词检索案例，支持分页与一次多页。
+- `advanced_search_cases`：按 AlphaLawyer 查询表达式检索案例，适合字段组合、层级条件和排除词。
+- `search_case_court_opinions`：检索案例并只返回列表条目中的“法院认为”内容，适合先比较多个案例的裁判理由。
+- `get_case_detail`：根据检索结果里的案例编号 `jid` 查看详情。
 - `search_laws`：按一个或多个关键词检索中国大陆法规，支持分页与一次多页。
 - `advanced_search_laws`：按 AlphaLawyer 查询表达式检索中国大陆法规，适合字段组合、层级条件和排除词。
 - `get_law_hit_articles`：根据法规编号 `lid` 和关键词，只返回该法规内命中的相关条文。
@@ -313,11 +324,33 @@ LawMCP 授权用于校验您是否有权使用 LawMCP。AlphaLawyer 登录态用
 }
 ```
 
-`query` 使用 AlphaLawyer 网页端表达式，例如 `字段:值`、`字段_层级:值`、同组 OR 的 `A||B`、多条件英文逗号拼接。MCP 会兼容部分常见网页展示名，例如将“法院认为”兼容为 `法院观点`，将“代理律师”“律师事务所”“裁判时间”分别兼容为 `律师`、`律所`、`裁判日期`。普通关键词检索优先使用 `search_cases`。
-
-### 法规关键词检索
-
-```json
+`query` 使用 AlphaLawyer 网页端表达式，例如 `字段:值`、`字段_层级:值`、同组 OR 的 `A||B`、多条件英文逗号拼接。MCP 会兼容部分常见网页展示名，例如将“法院认为”兼容为 `法院观点`，将“代理律师”“律师事务所”“裁判时间”分别兼容为 `律师`、`律所`、`裁判日期`。普通关键词检索优先使用 `search_cases`。
+
+### 案例法院认为检索
+
+```json
+{
+  "keywords": ["钢材加价款", "厦门"],
+  "page": 1,
+  "pageSize": 5,
+  "limit": 10
+}
+```
+
+也可以直接传 AlphaLawyer 查询表达式：
+
+```json
+{
+  "query": "案由_0:买卖合同纠纷,法院认为:加价款",
+  "limit": 10
+}
+```
+
+该工具只返回案例摘要和 `courtOpinion.text`，默认会清洗 AlphaLawyer 高亮 HTML。适合先看多条结果的裁判理由，再决定是否调用 `get_case_detail` 拉取全文。
+
+### 法规关键词检索
+
+```json
 {
   "keywords": ["民事诉讼法"],
   "field": "标题",