zuoguyoupan2023 北大法宝 MCP 一键安装技能
概述
此技能用于一键将北大法宝 MCP 服务配置写入目标 MCP 配置文件，免去手动逐个添加的繁琐操作。适用于团队内部推广、新设备配置、给同事/朋友安装北大法宝法律检索能力等场景。
服务选择逻辑
安装前先问用户已经购买/开通了哪些北大法宝 MCP 服务。用户不一定知道准确英文服务名，可以让用户提供：
- 服务名称或购买清单文字；
- 订单页、服务页、token 页面截图；
- 北大法宝后台里显示的已开通服务列表。
根据用户提供的信息，把已购买服务映射成脚本里的 --services 参数。不要替用户假定已经购买高级 MCP。用户完全不知道怎么选时，再建议从三项基础 MCP 开始：法规关键词检索、精准法条查找、司法案例关键词检索。
常见基础 MCP 服务
| 服务名 | 对应能力 | URL |
|---|---|---|
| pkulaw-law-keyword | 法规关键词检索 | mcp-law |
| pkulaw-fatiao | 精准法条查找 | mcp-fatiao |
| pkulaw-case | 司法案例关键词检索 | mcp-case |
高级可选 MCP 服务
以下服务只有在用户已经确认购买/开通对应订阅时才建议启用。不要让新手误以为必须一次性购买全部服务。
| 服务名 | 对应能力 | URL |
|---|---|---|
| pkulaw-law-search | 法规语义检索 | mcp-law-search-service |
| pkulaw-case-search | 案例语义检索 | mcp-case-search-service |
| pkulaw-citation | 引注/引用校验 | pku_citation_validator |
| pkulaw-hyperlink | 文档链接添加 | add-doc-link |
| pkulaw-recognition | 法律识别 | law_recognition |
| pkulaw-nl-sql | 自然语言/跨库检索 | assistant/mcp-pkulaw-search |
| pkulaw-case-number | 案号识别 | case_number_recognition |
触发场景
当用户提出以下需求时使用此技能：
- "帮我安装北大法宝MCP"
- "配置pkulaw MCP"
- "给新设备装北大法宝"
- "我也要用北大法宝检索"
- "怎么配置北大法宝MCP"
- "pkulaw setup"
工作流程
步骤一：获取 Authorization Token
向用户确认北大法宝 API 的 Bearer Token。该 Token 是敏感凭证。
获取方式：
- 用户已有 Token → 优先让用户通过环境变量
PKULAW_AUTH_TOKEN、终端交互或本机私有配置提供，不要让用户把真实 Token 写进仓库文件、示例、模板、截图或 Issue - 用户没有 Token → 引导用户在浏览器搜索“北大法宝 MCP”，进入北大法宝 MCP 服务页面，按需购买/开通服务。不会选时，建议先从法规关键词检索、精准法条查找、司法案例关键词检索三项开始。页面生成 Token 后，再回到本机用本 skill 配置。
步骤二：确认已购买服务
询问用户：
你购买/开通了哪些北大法宝 MCP 服务？可以直接发服务名称、购买页面文字、服务列表截图或 token 页面截图。我会根据这些信息选择要安装的 MCP。
映射规则：
- 如果用户说“法规关键词检索”或页面显示
mcp-law，安装pkulaw-law-keyword。 - 如果用户说“精准法条查找/法条检索”或页面显示
mcp-fatiao，安装pkulaw-fatiao。 - 如果用户说“司法案例关键词检索/案例检索”或页面显示
mcp-case，安装pkulaw-case。 - 如果用户提供高级服务名称，再按高级可选 MCP 表映射。
- 如果无法从截图/文字判断，先问清楚，不要乱装高级服务。
步骤三：执行安装脚本
根据已确认服务运行安装脚本。示例：只安装基础三项时：
PKULAW_AUTH_TOKEN="..." python3 scripts/install_pkulaw_mcp.py --mcp-path ~/.workbuddy/mcp.json
安装用户已购买的指定服务时：
PKULAW_AUTH_TOKEN="..." python3 scripts/install_pkulaw_mcp.py --services pkulaw-citation,pkulaw-hyperlink --mcp-path ~/.workbuddy/mcp.json
只有用户确认已购买全部高级 MCP 时，才使用：
PKULAW_AUTH_TOKEN="..." python3 scripts/install_pkulaw_mcp.py --services all --mcp-path ~/.workbuddy/mcp.json
脚本会：
- 读取指定的 MCP 配置文件（不存在则创建）
- 将所选北大法宝 MCP 配置合并进去（不覆盖其他已有配置）
- 输出新增/更新的服务列表
可选参数：
--mcp-path <path>指定自定义配置路径。常见目标包括 WorkBuddy 的~/.workbuddy/mcp.json，或其他运行时自己的 MCP 配置文件。--services basic只安装基础三项；用户未提供购买信息时可作为保守默认值。--services all或--include-advanced安装全部服务，仅适合已经确认全部订阅的用户。--services 服务名1,服务名2只安装用户已购买的指定服务。
步骤四：确认安装结果
检查脚本输出，确认服务均已成功配置。提醒用户重启对应运行时以加载新配置。
步骤五（可选）：验证 MCP 可用性
重启目标运行时后，可引导用户测试任一 MCP 服务是否正常响应，例如：
- 尝试使用 pkulaw-law-keyword 检索一条法规
- 尝试使用 pkulaw-fatiao 获取一个已知法条
- 尝试使用 pkulaw-case 搜索一个案例
卸载
如需移除北大法宝 MCP 配置：
python3 scripts/uninstall_pkulaw_mcp.py --mcp-path ~/.workbuddy/mcp.json
同样支持 --mcp-path <path> 参数指定自定义路径。
注意事项
- Token 安全：Authorization Token 是敏感信息，只放在本机环境变量、MCP 配置或私有文件里
- 增量合并：安装脚本采用合并策略，不会删除用户已有的其他 MCP 配置
- 重复安装：如果已安装过，再次运行会更新 Token（适用于 Token 过期后更换）
- 重启生效：修改 MCP 配置后通常必须重启目标运行时才能加载新配置
- 订阅要求：先按用户购买信息安装；高级 MCP 只有在用户确认已购买/开通时才启用
- 网络要求：所有 MCP 服务需要访问
apim-gateway.pkulaw.com，确保网络可达