convez.ai
MCP ServerSegurançaIntermediário
Declade

Lucairn SDKs

Declade/lucairn-sdks

Gateway de IA com privacidade: remove PII antes do modelo ver

Ver no GitHub
BomPluginScore · de 0 a 100

Cliente MCP Server TypeScript que integra Lucairn, um gateway de IA que remove dados pessoais de prompts antes de chegar ao modelo upstream. Oferece detecção de PII em três camadas, certificados de conformidade assinados e suporte para roteamento entre Anthropic e OpenAI com BYOK.

Instalação

$npx convez-ai Declade/lucairn-sdks

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 1 mês
Versão
bundle-verify-v1.2.0
Issues abertas
9
Contribuidores
2

Casos de uso

  • Processamento de dados sensíveis com conformidade garantida
  • Aplicações que lidam com informações pessoais em prompts
  • Integração com Claude Desktop, Cursor e outros clientes MCP

Veredito

Solução robusta para privacidade em IA, com pipeline de sanitização em três camadas e certificados Ed25519. Instalação via MCP é trivial, mas requer chave de API Lucairn e demanda compreensão de fluxos de redação de identidade.

README

A tradução para o português deste README ainda está na fila.

Lucairn SDKs

Official client libraries for Lucairn — an EU-based privacy-preserving AI gateway. Lucairn sits between your application (or AI agent) and the upstream LLM provider you choose, removes personal data from prompts before the model ever sees them, and returns a signed Lucairn Certificate proving what was redacted, when, and by which sanitizer layer.

This monorepo hosts four packages at parity:

  • @lucairn/mcp-server — Model Context Protocol server (one-line npx install for Claude Desktop, Cursor, Cline, Continue, …)
  • @lucairn/sdk — TypeScript / Node SDK
  • lucairn — Python SDK
  • github.com/declade/lucairn-sdks/go — Go SDK

Quick start (MCP)

For most agent use cases, the fastest path is the MCP server. No build step, no install — npx runs it on demand:

npx -y @lucairn/mcp-server

Add it to your MCP client config (Claude Desktop's claude_desktop_config.json, Cursor's mcp.json, Cline's cline_mcp_settings.json, Continue, etc.):

{
  "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>"
      }
    }
  }
}

Restart your client. The chat_via_lucairn tool becomes available immediately. See mcp-server/README.md for full details.

What it does

Each request through any Lucairn SDK follows the same pipeline:

  1. PII detection runs on every user message in three layers:
    • Layer 1 — Known-entity matching (your tenant's named entities)
    • Layer 2 — Presidio NER (names, emails, IBANs, addresses, phone numbers, customer IDs, …)
    • Layer 3 — GPU-hosted custom-trained PII shield (Enterprise tier only, optionally trained on your domain corpus)
  2. Detected PII is replaced with placeholders ([PERSON_1], [EMAIL_2], [IBAN_3], …) before the request reaches the upstream LLM.
  3. The selected upstream model sees only the sanitized text. It never receives raw personal data.
  4. The response is returned with a signed compliance certificate (Ed25519 witness signature + RFC 3161 timestamp + Sigstore Rekor inclusion proof).
  5. Response handling depends on tier:
    • Developer (free) — placeholders are returned verbatim. Useful for testing the redaction surface.
    • Pro / Enterprise — placeholders are re-linked back to the originals on the gateway before the response reaches your application.

For Lucairn-hosted Developer-tier callers, on-gateway pseudonymization happens before your LLM sees the request. Enterprise self-host deployments can run the entire stack inside the customer environment, in which case no raw identity data leaves that environment at all.

Provider routing

The gateway picks the upstream provider from the model parameter you send:

Model prefixUpstream providerBYOK env var
claude-*, anthropic-*AnthropicANTHROPIC_API_KEY
gpt-*, openai-*, o1-*, o3-*, o4-*OpenAIOPENAI_API_KEY

Cross-provider BYOK shipped in @lucairn/mcp-server@1.1.0 — set one or both keys in the same MCP config and the server forwards the matching one as X-Upstream-Key per request, so your provider account is billed directly.

Per-language SDKs

LanguagePackageVersionREADME
MCP server@lucairn/mcp-server1.2.7mcp-server/README.md
TypeScript@lucairn/sdk1.1.1ts/README.md
Pythonlucairn1.1.1python/README.md
Gogithub.com/declade/lucairn-sdks/gov1.1.1go/README.md

All SDKs are at parity at the observable level. Cross-language byte-equivalence is locked via shared Go-assembler-generated fixtures, so a certificate signed via one SDK verifies identically via the other two.

Get an API key

Sign up at https://lucairn.eu/account/signup. Free Developer tier: 500 requests/month, no credit card required.

Pro adds response re-linking, programmatic certificate JSON access, audit-event export, and higher quota. Enterprise adds self-host, BYOK with provider-side billing isolation, and the optional custom-trained PII shield (priced per scope).

See https://lucairn.eu/pricing for the full tier comparison.

Verify a response

Every response through any SDK gets a signed Lucairn certificate. Two surfaces:

  • HTML summary — DPO-friendly, available on every tier including Developer (free). Use getCertificateSummary (TS) / get_certificate_summary (Python) / GetCertificateSummary (Go), or paste the certificate URL into https://lucairn.eu/verify.
  • JSON certificate + local Ed25519 verify — Pro tier and above. Use getCertificate + verifyCertificate (and language equivalents). The verifier is in-tree — see ts/src/verify-certificate/, python/src/lucairn/verify_certificate/, and the internal/verify package under go/.

External RFC 3161 + Sigstore Rekor anchor verification is currently surfaced as pass-through metadata; full external anchor verification lands in a follow-up release.

Status

Production packages are versioned independently and tagged per the table above. Cross-language byte-equivalence is locked via shared fixtures. Follow CHANGELOG.md for release notes.

Links

Contributing

See CONTRIBUTING.md. Security reports: SECURITY.md.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados