简体中文 | English

聚法-法律数据智能服务 MCP Server

jufa-mcp-server 是聚法法律数据服务的开源 MCP 接入层。它在启动时连接聚法现有的 12 类远程 MCP Server，将当前可用工具聚合为一个本地 stdio Server，方便 WorkBuddy、CodeBuddy、Cursor 等兼容 MCP 的 AI 客户端统一接入。

本仓库只包含协议适配和请求转发代码，不包含聚法数据库、检索算法、计费实现或主站核心业务源码。实际法律数据由聚法托管服务提供。

数据能力

工具定义在进程启动时通过各上游的 tools/list 获取。重启本服务即可同步聚法平台最新启用的工具及参数定义。

Related MCP server: Legal Document AI MCP

获取 API Key

1. 访问聚法智能体数据平台并登录。

2. 在个人中心获取 API Key。

3. 使用前可查看接入指南和数据能力与积分价格。

API Key 属于敏感凭证。请只通过环境变量配置，不要写入代码、截图、日志或 Git 提交。

运行要求

• Node.js 20 或更高版本

• 可访问 https://www.jufaai.com

• 有效的聚法 API Key 和可用账户

从源码运行

git clone https://github.com/jufaai/jufa-mcp-server.git
cd jufa-mcp-server
npm ci
npm run build

macOS / Linux：

JUFA_API_KEY="你的_api_key" npm start

Windows PowerShell：

$env:JUFA_API_KEY="你的_api_key"
npm start

MCP 客户端配置

从源码构建后，可使用绝对路径配置：

{
  "mcpServers": {
    "jufa-mcp-server": {
      "command": "node",
      "args": ["C:/absolute/path/jufa-mcp-server/dist/index.js"],
      "env": {
        "JUFA_API_KEY": "你的_api_key"
      }
    }
  }
}

将来 npm 包正式发布后，可简化为：

{
  "mcpServers": {
    "jufa-mcp-server": {
      "command": "npx",
      "args": ["-y", "jufa-mcp-server"],
      "env": {
        "JUFA_API_KEY": "你的_api_key"
      }
    }
  }
}

当前仓库已完成 npm 打包配置，但尚未发布到 npm。发布前请继续使用源码构建方式。

在 WorkBuddy 中，可进入“连接器 → 自定义连接器”，按客户端支持的本地 MCP 配置方式填写上述命令和环境变量。组织公共连接器及腾讯云托管方式以平台审核结果为准。

环境变量

工作机制

1. 启动时依次向全部 12 类服务发送 initialize 和 tools/list。

2. 上游工具名转换为 jufa_{领域}_{原工具名}，避免不同领域重名。

3. 客户端调用工具时，本服务通过 Authorization: Bearer <JUFA_API_KEY> 转发到对应上游。

4. 上游返回的 content、structuredContent 和 isError 保持不变。

如果任一领域无法完成工具发现，进程会指出具体上游路径并终止，避免静默提供不完整能力。

计费说明

工具调用可能按照聚法智能体数据平台当前公布的积分价格扣费。鉴权、余额检查、调用日志、结果计费和业务数据处理均由聚法托管服务完成。本开源适配器不保存账户余额，也不实现或绕过计费逻辑。

常见问题

• Missing JUFA_API_KEY：没有配置 API Key，或变量值为空。

• HTTP 401/403：API Key 无效、停用、过期，或账户不可用。

• HTTP 402 或额度错误：账户余额不足，请在聚法平台查看余额和积分价格。

• Failed to discover MCP tools：错误信息会列出失败的 /mcp/... 路径；检查网络、API Key 和上游状态后重启。

• 工具清单未更新：工具元数据只在启动时同步，请重启 MCP 进程。

开发与验证

npm ci
npm run typecheck
npm test
npm run build
npm run smoke
npm pack --dry-run

测试使用本地模拟上游，不需要真实 API Key，也不会访问生产服务或产生积分。

安全

请阅读 SECURITY.md。不要在公开 Issue 中提交 API Key、账户信息、完整法律数据响应或其他敏感信息。

License

Apache License 2.0