mcpField
L
Lucairn Privacy Gateway

Lucairn Privacy Gateway

リモート
lucairn.euAI・エージェント22 週間前に更新

Lucairn Privacy Gateway について

Lucairn Privacy Gateway は、MCP サーバーと複数言語の SDK を提供し、上流 LLM に送る前に個人情報を検出・置換して、署名付きコンプライアンス証明書を返します。個人情報の処理を監査したいエージェントアプリ向けです。

主な機能

  1. 01転送前にプロンプト内の個人情報を検出・置換
  2. 02モデル名に応じて Anthropic または OpenAI にルーティング
  3. 03利用者の上流キーを転送
  4. 04署名付きコンプライアンス証明書を返却
  5. 05TypeScript、Python、Go の SDK を提供

活用シーン

  1. 01エージェントが LLM を呼び出す前にユーザーデータを匿名化
  2. 02モデルリクエストの匿名化を検証可能な形で記録
  3. 03独自の上流プロバイダーキーでリクエストをルーティング

MCP 対応

MCP サーバーは chat_via_lucairn ツールでゲートウェイ経由のチャットを提供します。MCP クライアントに設定すると、リクエストを Lucairn で処理してから上流 LLM に転送できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"lucairn-sdks": {
"command": "npx",
"args": [
"-y",
"@lucairn/mcp-server"
],
"env": {
"LUCAIRN_API_KEY": "<LUCAIRN_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"LUCAIRN_BASE_URL": "<LUCAIRN_BASE_URL>",
"LUCAIRN_TRANSPORT": "<LUCAIRN_TRANSPORT>"
}
}
}
}
起動コマンドnpx -y @lucairn/mcp-server
設定が必要な環境変数
LUCAIRN_API_KEYシークレットLucairn gateway API key (lcr_live_*). Issued at https://lucairn.eu/account/keys. Free tier requires BYOK upstream LLM keys (ANTHROPIC_API_KEY or OPENAI_API_KEY).
ANTHROPIC_API_KEYシークレットUpstream Anthropic API key. Used when the requested model is claude-* / anthropic-*. Required if you call Claude models on the free tier (BYOK).
OPENAI_API_KEYシークレットUpstream OpenAI API key. Used when the requested model routes to OpenAI. Required if you call OpenAI models on the free tier (BYOK).
LUCAIRN_BASE_URLOverride the gateway URL. Defaults to https://gateway.lucairn.eu (production). Set this to point at a self-hosted Lucairn deployment.
LUCAIRN_TRANSPORTTransport mode for the MCP server. One of 'direct-http' (default; v1.1+ behavior) or 'stdio-bridge' (v1.2+ opt-in).

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@lucairn/mcp-server1.2.9

ツール

1

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
max_tokensnumberはい応答で生成する最大トークン数。Anthropic Messages API で必須です。
messagesarrayはい会話メッセージ。各項目の形式は { role: "user" | "assistant", content: string | array } です。
modelstringはいモデル識別子。ルーティング規則:`claude-*` と `anthropic-*` は ANTHROPIC_API_KEY を介して Anthropic にルーティングされ、`gpt-*`、`openai-*`、`o1-*`、`o3-*`、`o4-*` は OPENAI_API_KEY を介して OpenAI にルーティングされます。例:`claude-sonnet-4-6`、`gpt-4o-mini`、`o3-mini`。BYOK を利用するには、MCP クライアントの環境変数に ANTHROPIC_API_KEY と OPENAI_API_KEY の一方または両方を設定します。一致判定では大文字と小文字は区別されません。
systemanyいいえ任意のシステムプロンプト。文字列またはコンテンツブロックの配列を指定できます。サニタイズポリシーはゲートウェイ側で API キーごとに設定されます(sanitize または passthrough_audit)。
temperaturenumberいいえ任意のサンプリング温度(0..1)。

詳細

Lucairn SDK

Lucairn の公式クライアントライブラリです。Lucairn は EU を拠点とする、プライバシーを保護する AI ゲートウェイです。アプリケーション(または AI エージェント)と、選択した上流 LLM プロバイダーの間に位置し、モデルに届く前にプロンプトから個人データを削除します。また、何が、いつ、どのサニタイザーレイヤーによってマスキングされたかを証明する、署名付きの Lucairn 証明書を返します。

このモノレポでは、同等の機能を備えた 4 つのパッケージを提供しています。

  • @lucairn/mcp-server — Model Context Protocol サーバー(Claude Desktop、Cursor、Cline、Continue などにワンライナーの npx でインストールできます)
  • @lucairn/sdk — TypeScript/Node SDK
  • lucairn — Python SDK
  • github.com/declade/lucairn-sdks/go — Go SDK

クイックスタート(MCP)

多くのエージェントの用途では、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. すべてのユーザーメッセージに対して、3 つのレイヤーで PII 検出を実行します。
    • レイヤー 1 — 既知のエンティティとの照合(テナント固有の名前付きエンティティ)
    • レイヤー 2 — Presidio NER(氏名、メールアドレス、IBAN、住所、電話番号、顧客 ID など)
    • レイヤー 3 — GPU でホストされるカスタム学習済み PII シールド(Enterprise ティアのみ。必要に応じてドメインコーパスで学習できます)
  2. 検出された PII は、リクエストが上流 LLM に届く前にプレースホルダー([PERSON_1]、[EMAIL_2]、[IBAN_3] など)に置き換えられます。
  3. 選択した上流モデルに渡されるのは、サニタイズ済みのテキストのみです。生の個人データを受け取ることはありません。
  4. 署名付きのコンプライアンス証明書(Ed25519 証人署名 + RFC 3161 タイムスタンプ + Sigstore Rekor の登録証明)とともに応答が返されます。
  5. 応答の処理はティアによって異なります。
    • Developer(無料) — プレースホルダーはそのまま返されます。マスキング範囲のテストに役立ちます。
    • Pro/Enterprise — 応答がアプリケーションに届く前に、ゲートウェイ上でプレースホルダーが元の値に再リンクされます。

Lucairn がホストする Developer ティアの呼び出し元では、LLM にリクエストが届く前に、ゲートウェイ上で仮名化が行われます。Enterprise のセルフホスト環境では、スタック全体を顧客の環境内で実行できるため、生の ID データがその環境の外に出ることはありません。

プロバイダーのルーティング

ゲートウェイは、指定した model パラメーターに基づいて上流プロバイダーを選択します。

モデルのプレフィックス上流プロバイダーBYOK 環境変数
claude-*、anthropic-*AnthropicANTHROPIC_API_KEY
gpt-*、openai-*、o1-*、o3-*、o4-*OpenAIOPENAI_API_KEY

クロスプロバイダー BYOK は @lucairn/[email protected] で提供されました。同じ MCP 設定に一方または両方のキーを設定すると、サーバーはリクエストごとに該当するキーを X-Upstream-Key として転送します。そのため、料金はプロバイダーのアカウントに直接請求されます。

言語別 SDK

言語パッケージバージョンREADME
MCP サーバー@lucairn/mcp-server1.2.7mcp-server/README.md
TypeScript@lucairn/sdk1.1.1ts/README.md
Pythonlucairn1.4.1python/README.md
Gogithub.com/declade/lucairn-sdks/gov1.3.1go/README.md

すべての SDK は、観測可能なレベルで同等の機能を備えています。言語をまたいだバイト単位の同等性は、Go アセンブラーで生成した共通フィクスチャによって保証されています。そのため、いずれかの SDK で署名された証明書は、ほかの 2 つの SDK でも同じように検証できます。

API キーの取得

https://lucairn.eu/account/signup で登録してください。無料の Developer プランでは、クレジットカード不要で月 500 件のリクエストが利用できます。

Pro では、レスポンスの再リンク、証明書 JSON へのプログラムからのアクセス、監査イベントのエクスポート、クォータの引き上げが追加されます。Enterprise では、セルフホスト、プロバイダー側の課金分離に対応した BYOK、オプションのカスタムトレーニング済み PII シールドが追加されます(価格はスコープごとに設定されます)。

各プランの詳しい比較については、https://lucairn.eu/pricing をご覧ください。

レスポンスの検証

いずれの SDK を通じたレスポンスにも、署名済みの Lucairn 証明書が付与されます。利用方法は 2 つあります。

  • 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 を検証します。3 つの関数はすべて、testdata/parity-corpus/ の共通 98 ケースコーパスで同じ結果を返します。描画と判断には、返された verified の値のみを使用してください。別のターンの証明書が受け入れられないよう、想定されるリクエスト ID を渡してください。

外部の RFC 3161 および Sigstore Rekor アンカー検証は、現在、パススルーメタデータとして提供されています。外部アンカーの完全な検証は、今後のリリースで追加されます。

ステータス

本番パッケージは個別にバージョン管理され、上の表に記載したタグが付けられています。言語をまたいだバイト単位の同等性は、共通フィクスチャによって保証されています。リリースノートは CHANGELOG.md をご確認ください。

リンク

コントリビューション

CONTRIBUTING.md をご覧ください。セキュリティに関する報告は SECURITY.md をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。