Lucairn Privacy Gateway

Lucairn SDK

面向 Lucairn 的官方客户端库——这是一个位于欧盟、保护隐私的 AI 网关。Lucairn 位于你的应用（或 AI Agent）与所选的上游大模型提供商之间，会在模型看到提示词之前移除其中的个人数据，并返回一份经过签名的 Lucairn 证书，证明脱敏了哪些内容、何时脱敏，以及由哪一层脱敏器完成。

此单体代码库包含四个功能对等的软件包：

• @lucairn/mcp-server — Model Context Protocol 服务（通过一行 npx 命令即可安装到 Claude Desktop、Cursor、Cline、Continue 等客户端）
• @lucairn/sdk — TypeScript / Node SDK
• lucairn — Python SDK
• github.com/declade/lucairn-sdks/go — Go SDK

快速开始（MCP）

对于大多数 Agent 使用场景，最快的方式是使用 MCP 服务。无需构建，无需安装——npx 会按需运行它：

npx -y @lucairn/mcp-server

将其添加到 MCP 客户端配置中（Claude Desktop 的 claude_desktop_config.json、Cursor 的 mcp.json、Cline 的 cline_mcp_settings.json、Continue 等）：

{
  "mcpServers": {
    "lucairn": {
      "command": "npx",
      "args": ["-y", "@lucairn/mcp-server"],
      "env": {
        "LUCAIRN_API_KEY": "<your_lucairn_api_key>",
        "ANTHROPIC_API_KEY": "<optional_byok_anthropic_key>",
        "OPENAI_API_KEY": "<optional_byok_openai_key>"
      }
    }
  }
}

重启客户端。chat_via_lucairn 工具会立即可用。完整详情请参阅 mcp-server/README.md。

功能说明

通过任何 Lucairn SDK 发出的请求都会遵循相同的处理流程：

1. 对每条用户消息进行三层 PII 检测：
   • 第 1 层 — 已知实体匹配（租户的命名实体）
   • 第 2 层 — Presidio NER（姓名、电子邮件、IBAN、地址、电话号码、客户 ID 等）
   • 第 3 层 — GPU 托管的自定义训练 PII 防护层（仅限 Enterprise 方案，可选用你的领域语料进行训练）
2. 检测到的 PII 会被占位符（[PERSON_1]、[EMAIL_2]、[IBAN_3] 等）替换，之后请求才会到达上游大模型。
3. 所选的上游模型只能看到脱敏后的文本，无法获取原始个人数据。
4. 返回的响应附带经过签名的合规证书（Ed25519 见证签名 + RFC 3161 时间戳 + Sigstore Rekor 纳入证明）。
5. 响应处理方式取决于方案：
   • Developer（免费） — 占位符会原样返回。适用于测试脱敏效果。
   • Pro / Enterprise — 在响应到达你的应用之前，网关会将占位符重新关联到原始内容。

对于由 Lucairn 托管、使用 Developer 方案的调用方，网关会在大模型看到请求之前进行假名化。Enterprise 可自托管部署可在客户环境中运行整个堆栈，此时不会有任何原始身份数据离开该环境。

提供商路由

网关会根据你发送的 model 参数选择上游提供商：

模型前缀	上游提供商	BYOK 环境变量
claude-*、anthropic-*	Anthropic	ANTHROPIC_API_KEY
gpt-*、openai-*、o1-*、o3-*、o4-*	OpenAI	OPENAI_API_KEY

跨提供商 BYOK 已在 @lucairn/[email protected] 中推出——在同一 MCP 配置中设置一个或两个密钥后，服务会在每次请求中通过 X-Upstream-Key 转发匹配的密钥，因此费用会直接计入你的提供商账户。

各语言 SDK

语言	软件包	版本	README
MCP 服务	@lucairn/mcp-server	1.2.7	mcp-server/README.md
TypeScript	@lucairn/sdk	1.1.1	ts/README.md
Python	lucairn	1.4.1	python/README.md
Go	github.com/declade/lucairn-sdks/go	v1.3.1	go/README.md

所有 SDK 在可观察层面上保持一致。通过共享的 Go 汇编器生成的测试夹具锁定跨语言字节等价性，因此，经一个 SDK 签署的证书可由另外两个 SDK 以相同方式验证。

获取 API 密钥

前往 https://lucairn.eu/account/signup 注册。免费 Developer 套餐：每月 500 次请求，无需信用卡。

Pro 套餐增加了响应重新关联、以编程方式访问证书 JSON、审计事件导出以及更高的配额。Enterprise 套餐增加了自托管、BYOK（提供商侧账单隔离），以及可选的定制训练 PII 防护盾（按范围定价）。

完整的套餐对比请参阅 https://lucairn.eu/pricing。

验证响应

通过任意 SDK 返回的每个响应都会获得一份签名的 Lucairn 证书。提供两种方式：

• HTML 摘要 — 便于 DPO 查看，所有套餐均可使用，包括免费 Developer 套餐。使用 getCertificateSummary（TS）/ get_certificate_summary（Python）/ GetCertificateSummary（Go），或将证书 URL 粘贴到 https://lucairn.eu/verify。

• JSON 证书 + 本地 Ed25519 验证 — Pro 套餐及以上可用。使用 getCertificate + verifyCertificate（及各语言对应方法）。验证器包含在代码库中 — 请参阅 ts/src/verify-certificate/、python/src/lucairn/verify_certificate/ 和 go/ 下的 internal/verify 包。

• 验证每项声明，而不只是见证签名 — verifyCertificateChain / verify_certificate_chain / VerifyCertificateChain 会使用你固定的各服务密钥，检查每项声明自身的签名、声明字节、类型化副本、已签名的上游请求哈希以及未签名的 cert_tier。三个方法在 testdata/parity-corpus/ 中共享的 98 个案例上均返回相同结果。仅根据返回的 verified 值进行呈现和决策；传入预期的请求 ID，以拒绝其他轮次的证书。

外部 RFC 3161 + Sigstore Rekor 锚点验证目前以透传元数据的形式提供；完整的外部锚点验证将在后续版本中推出。

状态

生产软件包独立进行版本管理，并按上表打标签。跨语言字节等价性通过共享测试夹具锁定。请参阅 CHANGELOG.md 了解版本说明。

链接

• 主站：https://lucairn.eu
• 注册（免费 Developer 套餐）：https://lucairn.eu/account/signup
• 定价：https://lucairn.eu/pricing
• MCP 设置指南：https://lucairn.eu/developer/mcp
• OpenAI SDK 设置指南：https://lucairn.eu/developer/openai
• 验证证书：https://lucairn.eu/verify
• Glama 列表：https://glama.ai/mcp/servers/Declade/lucairn-sdks
• mcp.so 列表：https://mcp.so/server/lucairn-privacy-gateway/Declade
• npm — @lucairn/mcp-server：https://www.npmjs.com/package/@lucairn/mcp-server
• npm — @lucairn/sdk：https://www.npmjs.com/package/@lucairn/sdk
• PyPI — lucairn：https://pypi.org/project/lucairn/

贡献

请参阅 CONTRIBUTING.md。安全问题报告：SECURITY.md。

许可证

MIT — 请参阅 LICENSE。