nexus-legal

@nexus-legal/mcp

面向 Nexus Legal 的 MCP（Model Context Protocol）服务——向 Claude Desktop、Claude Code、Cursor 及任何其他兼容 MCP 的客户端提供 27 项专业法律能力。

这是什么？ 只需 30 秒，即可将 Claude 连接到 Nexus。之后，Claude 就能执行 ISO 31000 法律分析、蒙特卡洛诉讼模拟、判例检索、法律文书起草、行政法学说分析、对抗式红队测试、多司法管辖区比较（跨境）、引文核验、程序期限计算、法条↔判例引文图谱，以及通过 file_id 分析 Box 文件（box_analyze）——全程无需离开对话。

---

快速安装

1. 生成 MCP 密钥

访问 legal.nexusquantum.legal/developers，选择 "MCP server"，为密钥命名（例如“个人 MacBook”），然后点击 + Create MCP key。复制 nlk_... 密钥——它只会显示一次。

2. 配置客户端

Claude Desktop（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "nexus-legal": {
      "command": "npx",
      "args": ["-y", "@nexus-legal/mcp"],
      "env": {
        "NEXUS_API_KEY": "nlk_YOUR_KEY_HERE"
      }
    }
  }
}

重启 Claude Desktop。你会在聊天中看到一个 🔌 图标，其中列出了 27 个 Nexus 工具。

Claude Desktop（Windows）

使用相同内容编辑 %APPDATA%\Claude\claude_desktop_config.json。

Claude Code（CLI）

claude mcp add nexus-legal -- npx -y @nexus-legal/mcp
# Then set your key:
export NEXUS_API_KEY=nlk_YOUR_KEY_HERE

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "nexus-legal": {
      "command": "npx",
      "args": ["-y", "@nexus-legal/mcp"],
      "env": { "NEXUS_API_KEY": "nlk_YOUR_KEY_HERE" }
    }
  }
}

3. 试用

在 Claude Desktop 中输入：

使用 Nexus 分析这份合同，司法管辖区为 GB，商业分支，保守配置文件：«[在此粘贴合同文本]»

Claude 将调用 nexus_analyze 工具，并返回包含确定性锁定标记 [L1]/[L2-J]/[L3-NV]/[L4]、阻断信号 [L5-C]/[L5-P] 以及 NEXUS-AUDIT-TRAIL 区块的报告。

---

27 个工具

工具	功能	典型费用
nexus_analyze	完整法律分析（节点 A — ISO 31000）	1-3 个额度
nexus_consulta	开放式法律问题，可附带或不附带文档	1 个额度
nexus_draft	法律文书起草（上诉、诉状、答辩、条款……）	2-4 个额度
nexus_audit	对节点 A 分析进行交叉审计（节点 B）	1-2 个额度
nexus_consensus	多 Agent 共识节点 A ↔ 节点 B（分析与对抗性审计循环进行，直至达成共识；必须提供 jurisdiction；耗时较长，约 3-6 分钟）	3-7 个额度
nexus_monte_carlo	蒙特卡洛情景模拟（ISO 31000 §6）	4 个额度
nexus_doctrina	按司法管辖区搜索行政法理	1 个额度
nexus_opinion	针对先前分析获取多 LLM 第二意见	2 个额度
nexus_redteam	对抗性红队分析（以结构化 JSON 列出漏洞）	5 个额度
nexus_adversarial	针对先前分析撰写对抗性论证	2-3 个额度
nexus_cross_border_compare	多司法管辖区比较（2-15 个司法管辖区）	2-4 个额度
nexus_jurisprudencia_search	在多司法管辖区判例语料库中进行语义搜索	需要余额，以及该司法管辖区的判例法附加服务
verify_cita	对照官方语料库，确定性地核验一条引文（判决或条文）	需要余额（如果引文属于判例法，还需要判例法附加服务）
plazos_calcular	按审理机构计算程序时限。必须提供 jurisdiction，没有默认值：ES（LEC + LOPJ、CGPJ/地区节假日、8 月为非工作期）或 GB-EAW（CPR r 2.8，完整日，英格兰和威尔士银行假日，8 月无休庭期）。苏格兰和北爱尔兰不受支持：其规则和节假日各不相同	需要余额
cruce_normativa_jurisprudencia	引文图谱：条文 ↔ 判决	需要余额，以及判例法附加服务
box_analyze	按 file_id 分析 Box 文件（需要已建立有效的 Box 连接）	1-2 个额度
nexus_verificacion	核验中心：对照官方语料库检查文档中的每一条引文（确定性核验，不产生 LLM 费用）	需要余额
nexus_playbook	针对先前分析制定策略性谈判方案	2-3 个额度
nexus_compare_versions	比较文档的两个版本（V1 ↔ V2）	2 个额度
nexus_conflict_check	对案卷中的各方进行利益冲突检查	1 个额度
nexus_inbox	全事务所待办收件箱（显示需要采取行动的事项）	需要余额
nexus_chat	结合案情上下文进行法律聊天	1 个额度
nexus_normativa_search	对现行法律进行语义搜索	需要余额，以及该司法管辖区的立法附加服务
nexus_normativa_articulo	查询某一日期有效的条文原文（lex temporis）	需要余额，以及立法附加服务
nexus_normativa_pyramid	立法层级：按层级查看覆盖范围	需要余额
nexus_corpus_coverage	判例法语料库清单	只读
nexus_normativa_coverage	立法语料库覆盖范围（司法管辖区 + 更新情况）	只读

计费：MCP 服务并非免费。每次调用都需要账户有 大于 0 的额度余额（从第一分钟起即收费）。高级内容按 司法管辖区附加服务 提供：判例法和额外的 立法均为附加服务（第 3 层）——订阅包含一个司法管辖区的立法。没有相应的附加服务时，对该司法管辖区的搜索和查询会返回 403 CONTENT_NOT_ENTITLED。 关于司法辖区与覆盖范围。 可选择 63 个司法辖区代码（GB、ES、CO、SG、US，以及 US-CA／US-NY／US-DE／US-TX 州级覆盖项、用于跨境的 MULTI 等）。可选择不等于有依据：某个司法辖区实际由哪些语料支持——包含多少条法规、我们的副本最后一次编写时间、是否启用了搜索——各不相同，不能从此列表中推断。使用你的密钥调用 nexus_normativa_coverage：它会返回你的账户已启用的司法辖区及其各自的数据。没有依据语料的司法辖区仍可进行分析，但无法针对官方来源提供逐字引文。

---

自带引擎（BYO）账户——注册前你会看到什么

部分账户已配置为法律内容生成仅通过律所自己的 LLM 引擎运行，不设备用引擎链。这不是限制，而是确保文档绝不会发送到 Nexus 引擎。

未注册并启用任何提供商时，所有生成式工具 （nexus_analyze、nexus_consulta、nexus_chat、nexus_draft、nexus_audit、 nexus_adversarial、nexus_redteam、nexus_doctrina、nexus_consensus、 nexus_monte_carlo、nexus_opinion、nexus_playbook、nexus_compare_versions、 nexus_cross_border_compare、box_analyze）都会返回：

Error running nexus_analyze: BYO_PROVIDER_REQUIRED: This account requires its own
BYO LLM engine for AI-generative endpoints … This is a configuration state, not a
transient failure — retrying returns the same 409. Register and enable a provider
via POST /api/v1/llm-providers, then retry.

重试无法解决问题，而且运行在此处停止时不会扣除积分。注册一次引擎（POST /api/v1/llm-providers，或在应用中点击标题栏 → AI 模型），然后重新运行。

推理引擎与长时间分析

如果你的引擎是推理模型（DeepSeek V-pro、o1 风格模型、带思考功能的 Claude 5），一次复杂分析可能耗时超过同步 HTTP 请求所允许的时长。网关会在 300 s 后关闭连接——这是我们必须遵守的上限，无法提高。

2026-08-18 实测：在 BYO DeepSeek 引擎上，对约 5 KB 的合同使用 mode: "auditoria" 运行 nexus_analyze，耗时超过上限并返回 502。这不是你的引擎出了故障：推理模型会将大量生成额度用于思考，然后才开始输出；如果思考过程中额度耗尽，Nexus 会自动以更大的额度重新发起调用，因此还会进一步增加实际耗时。

有两种解决方法，按优先顺序排列：

1. 对此类组合使用异步路径：调用 POST /api/v1/jobs 并传入 kind: "analyze"，会返回 202 和一个 jobId，你可以轮询该任务（或使用签名 Webhook）。不受实际耗时限制。 推理引擎以及大型文档的 auditoria 模式都应使用此方式。
2. 通过 MCP 工具使用 mode: "standard"，耗时会显著缩短。

平台引擎和 mode: "standard" 不受影响：此时应使用同步工具，它仍是默认方式。

只读工具无需引擎即可工作，因为它们不会生成内容： nexus_jurisprudencia_search、verify_cita、nexus_verificacion、 nexus_normativa_search / _articulo / _pyramid、nexus_corpus_coverage、 nexus_normativa_coverage、cruce_normativa_jurisprudencia、plazos_calcular、 nexus_conflict_check（确定性名称匹配，不使用 LLM）和 nexus_inbox。

---

环境变量

变量	默认值	描述
NEXUS_API_KEY	—	**必需。**具有 mcp 范围的 nlk_... 密钥。
NEXUS_BASE_URL	https://legal.nexusquantum.legal	用于测试或可自托管环境。
NEXUS_TIMEOUT_MS	180000（3 分钟）	长时间分析的超时时间。

**语言。**此软件包会向每个客户端发送相同的工具描述——MCP 会在 tools/list 中一次性发布这些描述，并且这里没有任何工具接受 language 参数——因此描述和渲染的输出均为英文。工具生成法律交付成果时，其语言取决于司法管辖区和账户，而非此 README。

你可以按自己的习惯指定角色和当事方。professionalRole 接受 lawyer、solicitor、barrister、prosecutor、notary、registrar、judge、in-house 和 individual。proceduralSide 接受你的法庭实际使用的术语：claimant（英格兰和威尔士，CPR r 2.3）、pursuer（苏格兰）、plaintiff（北爱尔兰，该地区未采用 CPR）、defendant、defender。原有的西班牙语线路值——abogado、demandante、auditoria——保持不变，仍然有效：这只是增加了其他拼写形式，并未弃用任何值。在进入分析之前，所有值都会解析为相同的协议值，因此在任何调用中，两种写法都可以互换使用。

**API 版本：**此服务连接到 Nexus v1 API，与 TypeScript 和 Python SDK 使用的版本相同。只读和验证工具调用 /api/v1/* 路由；生成式工具则通过后端 node 路由接入，使用相同的 nlk_ 密钥（mcp 范围）、相同的计费方式以及相同的自带模型（BYO）强制执行机制。

此 stdio 软件包提供目录中 27 项功能。远程连接器（https://legal.nexusquantum.legal/api/mcp，无需安装）还提供案件文件、律所记忆、律所治理、法律分析、账户和计费功能。如需使用这些功能，请使用远程连接器或直接调用 v1 API。

---

隐私与 GDPR

• **欧盟基础设施上的零保留。**通过 MCP 发送的文档会在 Railway europe-west4-drams3a（荷兰）的 RAM 中处理，默认不会持久化到数据库。Nexus 零保留政策适用于 100% 的 MCP 流量，与网页流量完全相同。
• **PII 守护程序。**在任何内容传至大模型之前，后端会使用可逆令牌（[DNI_1]、[ACCOUNT_3]……）对国家身份证号码、IBAN、电话号码、电子邮件和账号进行匿名化处理。MCP 客户端看到的始终是已由我们的流程重新识别的信息。
• **审计。**每次工具调用都会记录在 analysis_costs 和 api_usage_stats 中（附带 via_api_key_id），以便计费和追踪。

---

支持

• 电子邮件：[email protected]
• 文档：https://legal.nexusquantum.legal/developers
• 问题反馈：https://github.com/djtellado/nexus-legal-prod/issues

---

许可证

Apache-2.0 — 参见 LICENSE 和 NOTICE。

版权 2026 Nexus Legal · Quantum Nexus Ventures。