法律AI服务

accurLex MCP Server 是一个远程法律AI服务,提供法律问答、法条检索、合同审查和法律文书生成功能,适用于AI客户端集成。

  • by MrPunchLeonardo
  • JavaScript
  • 混合部署
  • 更新于
在 GitHub 查看 MrPunchLeoanrdo/accurlex-mcp-server

使用说明

accurLex MCP Server

accurLex 知法(accurlex.com)的 远程 MCP 服务:一次配置,让 Cursor、Claude Code、Codex、VS Code 等 AI 客户端直接调用中国法律能力——法律问答、法条检索、合同审查、法律文书生成。

本服务是 Streamable HTTP(MCP 协议 2026-07-28)远程端点,不需要本地安装服务端;API Key 在 开放平台控制台 创建。


快速开始

1. 创建 API Key

  1. 打开 accurLex 开放平台控制台 并登录
  2. 创建一个 API Key(ak_live_ 开头),勾选需要的权限(scope)
  3. 只把 Key 放在服务端环境变量或客户端密钥管理中,不要提交到公开仓库

2. 配置客户端

以 Cursor / Claude Code / VS Code 的 .mcp.json 为例:

{
  "mcpServers": {
    "accurlex": {
      "type": "http",
      "url": "https://accurlex.com/mcp/stream",
      "headers": {
        "Authorization": "Bearer ak_live_YOUR_API_KEY"
      }
    }
  }
}

也可以直接用本包生成配置:

# JSON(Cursor / Claude Code / VS Code)
npx accurlex-mcp-server --key ak_live_YOUR_API_KEY

# TOML(Codex CLI)
npx accurlex-mcp-server --key ak_live_YOUR_API_KEY --format toml

更多客户端配置见 docs/client-configs.md。

3. 开始使用

配置完成后刷新工具列表,向 AI 提问,例如:

  • “根据《民法典》分析一下违约金过高能否请求调整?”
  • “审查这份合同的付款条款和违约责任”
  • “帮我起草一份民事起诉状”

端点与协议

项目 值
端点 POST https://accurlex.com/mcp/stream
协议 MCP 2026-07-28,Streamable HTTP(无状态,不需要会话 ID)
认证 请求头 Authorization: Bearer ak_live_...
请求体 单条 JSON-RPC 2.0 消息,最大 2MB
流式 Accept 含 text/event-stream 时返回 SSE,否则单条 JSON

请求头

头 说明
MCP-Protocol-Version 2026-07-28
Mcp-Method 与 body 的 method 一致,如 tools/call
Mcp-Name tools/call 必填,与 body.params.name 一致
Accept application/json, text/event-stream

工具

工具 必填参数 计费
accurlex_legal_qa question deep 免费(每日 100 次,≤10000 字符);expert 付费 5 点(≤30000 字符)
accurlex_law_search prompt deep 免费(每日 100 次,≤10000 字符);expert 促销期免费(≤30000 字符,限时免费至 2026-10-15),到期自动恢复付费 5 点
accurlex_contract_review contract_text + standpoint 付费 10 点(合计 ≤30000 字符)
accurlex_document_draft document_type + facts 付费 10 点(合计 ≤30000 字符)
accurlex_account_usage 无 免费,不消耗点数

完整 JSON Schema 见 schemas/tools.json,调用示例见 examples/。

调用示例

server/discover(协议协商):

curl -sS -X POST https://accurlex.com/mcp/stream \
  -H "Authorization: Bearer ak_live_YOUR_API_KEY" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

tools/call(deep 免费法律问答):

curl -sS -X POST https://accurlex.com/mcp/stream \
  -H "Authorization: Bearer ak_live_YOUR_API_KEY" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: accurlex_legal_qa" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"accurlex_legal_qa","arguments":{"question":"合同约定的违约金过高时,可以请求法院调整吗?","mode":"deep"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

JavaScript 与 Python 示例见 examples/。

计费与额度

  • 与 accurLex REST API 共用同一套 API Key、scope、每日免费额度与点数计费
  • 免费调用也写入用量台账(0 点);付费调用失败自动退款
  • 服务端无状态、不提供请求级去重;客户端应避免自动重试付费工具调用
  • SSE 连接断开即取消:计费后断连自动退款,计费前断连不扣费

错误处理

完整错误码表(协议层 JSON-RPC 错误码、HTTP 状态码、工具级 isError 错误码及处理建议)见 accurLex MCP 文档 · 错误码。要点:

  • 工具级失败 HTTP 仍为 200,必须检查 result.isError 与 structuredContent.error (如 scope_denied、daily_quota_exceeded、exceed_char_limit、too_many_requests、cancelled)
  • 协议/传输层错误返回 JSON-RPC error 字段:-32022(协议版本不支持)、-32020(请求头与 body 不一致)、 -32000(请求体超过 2MB)、-32700 / -32600 / -32601(JSON-RPC 解析/请求/方法错误)
  • IP 层限流返回 HTTP 429 普通 JSON:{"error":"too_many_requests"}

支持范围

  • 支持 2026-07-28 及之后的 MCP 协议版本(Streamable HTTP / 无状态)
  • 旧版 initialize 握手(2024/2025)与旧版 stdio 包不兼容,已退役

许可

MIT License,见 LICENSE。