北大法宝 MCP
把北大法宝接入支持 MCP 的 AI 客户端，用自然语言检索法规、查询案例，并按账户权限获取法律资料。
这个项目在客户端与北大法宝 MCP 服务之间做了一层转接：安装包不含凭据，Token 配置在运行桥接服务的环境中。模型通过两个工具查看可用接口、发起查询，不需要在每次调用时传入 Token。
安装
方法一：手动配置
需要 Node.js 22 或更高版本、支持 stdio 的 MCP 客户端，以及可用的北大法宝 Token。
- 安装 Node.js 22 或更高版本，运行
node --version和npx --version确认命令可用。 - 打开目标客户端的 MCP 配置，新增一个 stdio 服务。先在本地私密位置备份原配置，保留已有的其他服务。
- 使用下面的配置；Token 通过客户端的私密环境变量设置或本地私人配置填写，不要把示例占位符当作真实凭据。
{
"mcpServers": {
"pkulaw": {
"command": "npx",
"args": ["-y", "@adelagary/pkulaw-tokenless-bridge@0.1.0"],
"env": {
"PKULAW_TOKEN": "YOUR_PKULAW_TOKEN"
}
}
}
}
PKULAW_TOKEN 只填写 Token 本身，不要加 Bearer 前缀。不要带空格或换行。程序不会自动读取 .env 文件，需要由客户端或运行环境传入变量。不同客户端的配置文件位置和外层字段可能不同，请按客户端要求填写。
配置中的启动命令为 npx -y @adelagary/pkulaw-tokenless-bridge@0.1.0。首次启动会由 npx 获取对应 npm 包；stdio 服务等待客户端通信，不会打开登录页或提供 HTTP 地址。
保存后重新加载 MCP 服务，检查初始化是否成功，以及客户端是否能列出下方两个桥接工具。这只能确认程序可运行，不能证明 Token 有效或账户具有数据权限。确认查询可能消耗账户额度后，再发起一次需要的只读查询。
例如，可以让 AI：
查看北大法宝当前账户有哪些可用工具，再检索与劳动合同解除有关的法规。
方法二：让 AI Agent 帮你安装
把下面的提示词交给能操作本机配置的 AI Agent。涉及 Token 时，请自己在客户端或本地安全输入界面填写，不要粘贴到对话中。
请阅读 https://github.com/shiroidaoqi/pkulaw-mcp 的 README，帮我安装北大法宝 MCP。先检测或询问操作系统和目标客户端，确认其 stdio 配置方式与 Node.js ≥22；不要猜配置路径。在本地私密位置备份配置，保留其他 MCP 服务，再按 README 配置指定版本。Token 由我通过安全输入或客户端环境变量设置，不要索取、显示或写入聊天及公开文件；只填纯 Token，不加 Bearer 前缀，不走 OAuth，不额外授予权限。完成后验证初始化及两个桥接工具可见；这不代表法宝认证成功。如需查询验证，先说明可能消耗积分或额度，得到我授权后仅做最小只读查询。报告实际结果与错误，不要把安装成功当成查询成功。
工具怎么用
桥接层提供两个工具：
| 工具 | 参数 | 用途 |
|---|---|---|
pkulaw_list_upstream_tools |
可选 cursor |
获取当前账户可用的工具及参数说明；如返回 nextCursor，可继续翻页。 |
pkulaw_call_upstream_tool |
必填 name、arguments |
按工具名称和参数对象调用北大法宝接口。 |
通常先查看工具列表，再按返回的参数说明发起查询。工具清单来自上游服务，不在项目中写死；不同账户的可用工具、数据范围和调用额度可能不同。
可用于法规检索、法规正文获取、案例检索等工作，具体以当前账户返回的工具为准。案例检索结果不等于裁判文书全文，能否获取全文取决于上游是否提供相应接口及账户权限。
每次调用使用独立会话，操作超时为 30 秒；输入参数上限 128 KiB，返回数据上限 1 MiB。结果较大时，可按上游工具支持的分页方式分次获取。
凭据与隐私
安装包不附带凭据，使用时需要配置自己的北大法宝 Token。tokenless 指分发包不含 Token，工具调用参数中也不需要填写 Token，并不代表匿名访问法宝。
Token 仅通过 PKULAW_TOKEN 环境变量传入，不要放在工具参数、聊天、Issue 或公开配置中。查询内容和返回结果会经过所用的 MCP 客户端与北大法宝；如果另行部署到托管环境，也会经过该环境，请留意敏感材料和凭据的访问权限。
本程序通过 stdio 与客户端通信，不直接提供远程 HTTP 服务。账户的数据权限、调用额度与 Token 有效期由北大法宝决定。
常见问题
认证失败
检查 Token 是否有效、PKULAW_TOKEN 是否传入运行环境，以及是否误加了 Bearer 前缀。
客户端只显示两个工具
这是桥接层的设计。先调用 pkulaw_list_upstream_tools 查看北大法宝提供的具体工具，再通过 pkulaw_call_upstream_tool 使用它们。
工具能调用，但没有返回预期资料
先核对工具参数，再检查账户的数据权限、调用额度和服务可用性。桥接层不会增加账户权限或绕过额度限制。
本地开发
在仓库目录中运行：
npm ci
npm run check
npm test
使用 npm start 启动 stdio 服务，PKULAW_TOKEN 仍需由运行环境传入。
许可证
MIT。北大法宝数据与接口的使用以其服务条款及账户权限为准。