Lucairn Privacy Gateway について
Lucairn Privacy Gateway は、MCP サーバーと複数言語の SDK を提供し、上流 LLM に送る前に個人情報を検出・置換して、署名付きコンプライアンス証明書を返します。個人情報の処理を監査したいエージェントアプリ向けです。
主な機能
- 01転送前にプロンプト内の個人情報を検出・置換
- 02モデル名に応じて Anthropic または OpenAI にルーティング
- 03利用者の上流キーを転送
- 04署名付きコンプライアンス証明書を返却
- 05TypeScript、Python、Go の SDK を提供
活用シーン
- 01エージェントが LLM を呼び出す前にユーザーデータを匿名化
- 02モデルリクエストの匿名化を検証可能な形で記録
- 03独自の上流プロバイダーキーでリクエストをルーティング
MCP 対応
MCP サーバーは chat_via_lucairn ツールでゲートウェイ経由のチャットを提供します。MCP クライアントに設定すると、リクエストを Lucairn で処理してから上流 LLM に転送できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @lucairn/mcp-serverLUCAIRN_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
1掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| max_tokens | number | はい | 応答で生成する最大トークン数。Anthropic Messages API で必須です。 |
| messages | array | はい | 会話メッセージ。各項目の形式は { role: "user" | "assistant", content: string | array } です。 |
| model | string | はい | モデル識別子。ルーティング規則:`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 の一方または両方を設定します。一致判定では大文字と小文字は区別されません。 |
| system | any | いいえ | 任意のシステムプロンプト。文字列またはコンテンツブロックの配列を指定できます。サニタイズポリシーはゲートウェイ側で API キーごとに設定されます(sanitize または passthrough_audit)。 |
| temperature | number | いいえ | 任意のサンプリング温度(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 SDKlucairn— Python SDKgithub.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 を経由する各リクエストは、同じパイプラインに従います。
- すべてのユーザーメッセージに対して、3 つのレイヤーで PII 検出を実行します。
- レイヤー 1 — 既知のエンティティとの照合(テナント固有の名前付きエンティティ)
- レイヤー 2 — Presidio NER(氏名、メールアドレス、IBAN、住所、電話番号、顧客 ID など)
- レイヤー 3 — GPU でホストされるカスタム学習済み PII シールド(Enterprise ティアのみ。必要に応じてドメインコーパスで学習できます)
- 検出された PII は、リクエストが上流 LLM に届く前にプレースホルダー(
[PERSON_1]、[EMAIL_2]、[IBAN_3]など)に置き換えられます。 - 選択した上流モデルに渡されるのは、サニタイズ済みのテキストのみです。生の個人データを受け取ることはありません。
- 署名付きのコンプライアンス証明書(Ed25519 証人署名 + RFC 3161 タイムスタンプ + Sigstore Rekor の登録証明)とともに応答が返されます。
- 応答の処理はティアによって異なります。
- Developer(無料) — プレースホルダーはそのまま返されます。マスキング範囲のテストに役立ちます。
- Pro/Enterprise — 応答がアプリケーションに届く前に、ゲートウェイ上でプレースホルダーが元の値に再リンクされます。
Lucairn がホストする Developer ティアの呼び出し元では、LLM にリクエストが届く前に、ゲートウェイ上で仮名化が行われます。Enterprise のセルフホスト環境では、スタック全体を顧客の環境内で実行できるため、生の ID データがその環境の外に出ることはありません。
プロバイダーのルーティング
ゲートウェイは、指定した 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 で署名された証明書は、ほかの 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 をご確認ください。
リンク
- メインサイト: 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 をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。