EnigmAgent MCP

EnigmAgent

ローカルでの暗号化された認証情報の保存と、AI エージェントのオペレーター承認済み実行を実現します。 統合版 3.0.0 には、認証付き Vault、Node 管理ツール、制限付き MCP/REST ゲートウェイ、Python クライアント、10 種類のネイティブなフレームワーク統合が含まれています。

まずはこちら

目的	参照先
リリース内容とテスト済みの機能を確認する	統合版リリース v3
バージョン付き配布物をダウンロードする	GitHub リリース
ネイティブなエージェントフレームワークを利用する	Python SDK
MCP/REST ゲートウェイを実行する	ゲートウェイ
アプリケーションコードを書かずに Vault を管理する	管理ツール
ソースを固定したコンテナを実行する	コンテナ
セキュリティ境界を確認する	脅威モデルとセキュリティポリシー
以前のソースバージョンを確認する	保存済みバージョン
統合のエビデンスを確認する	ネイティブ実行時エビデンス

パッケージレジストリのバージョンとブラウザーストアのパッケージは、別々の公開チャネルです。 GitHub のソース変更によって、npm、PyPI、ブラウザー拡張機能、またはユーザーの既存インストールが自動的に更新されることはありません。バージョン付きリリースの成果物とチェックサムを使用し、インストール前にレジストリの実際のバージョンを確認してください。

固定操作のブローカーを使う理由

復号された認証情報を返すツールは、その認証情報を呼び出し元にも渡します。プレースホルダー構文だけでは、認証情報がエージェントのコンテキストに入るのを防げません。そのため、EnigmAgent は次の 2 つのモードを分けています。

• エージェントモード： オペレーターが固定の GET/HEAD 操作を定義します。エージェントが選択できるのは操作名のみです。ブローカーは設定済みの送信先に認証情報を付加し、{operation, status, ok} のみを返します。上流のレスポンスボディとヘッダーは、認証情報を反映またはエンコードしたものも含めて破棄されます。
• 明示的な信頼済みバックエンドモード： 未加工の値を解決するには、明示的なオプトインが必要です。このモードは操作ブローカーの転送方式と互換性がなく、モデルからデータを隔離するインターフェースではありません。

デフォルトの MCP モードで公開されるのはメタデータのみです。REST では常に認証が必要です。ブローカーが許可する送信先は、パブリック IPv4 の HTTPS のみです。固定された 127.0.0.1 の HTTP 送信先を使用するには、オペレーターによる明示的な有効化が必要です。リダイレクト、ユーザーが選択した URL/ヘッダー、およびプライベート／予約済みの送信先への通信は許可されません。

ネイティブ統合

フレームワーク	ファクトリーキー	テスト済みパッケージ	バージョン
LangChain	langchain	langchain-core	1.6.3
LangGraph	langgraph	langgraph	1.2.11
LlamaIndex	llamaindex	llama-index-core	0.14.24
CrewAI	crewai	crewai	1.15.22
Haystack	haystack	haystack-ai	3.1.1
Microsoft Agent Framework	agent_framework	agent-framework-core	1.18.0
smolagents	smolagents	smolagents	1.26.0
Agno	agno	agno	3.0.10
PydanticAI	pydantic_ai	pydantic-ai-slim	2.44.0
AutoGen Core	autogen	autogen-core	0.7.5

これらはこのリポジトリで保守されている、サードパーティ製フレームワークとの互換性を実現する統合機能です。それぞれ、合成した暗号化済み Vault と実際の認証付きローカルサービスを使って実行されます。テストでは、ネイティブな結果、利用可能なトレース／シリアライズのインターフェース、未知の操作が拒否されることを確認します。上流プロジェクトによる推奨や取り込み、モデルの品質、正式な非干渉性を主張するものではありません。

LangGraph にはチェックポイントの検査機能が含まれます。Haystack には、信頼するモジュールを明示的に許可リストで指定した、シリアライズ済みパイプラインの往復テストが含まれます。PydanticAI は、ローカルの FunctionModel を使ったエージェントのループを実行します。有料モデルへの呼び出しは行いません。MCP の相互運用性も、独立してインストールした公式 Python MCP クライアントを使って確認しています。

認証済みストレージ

新しい保管庫では、Argon2id と AES-256-GCM を使用します。保管庫形式 v2 では、名前、ドメイン、値を含むエントリー全体をまとめて認証します。エンベロープヘッダーは関連データとしてバインドされます。書き込みはリビジョンを確認し、一時ファイルへの書き込み後にフラッシュしてから、現在のファイルをアトミックに置き換えます。書き込みに失敗した場合、セッションのコミット済みインメモリ状態は更新されません。ロック解除に失敗すると、以前のセッションはロックされます。

レガシー形式 v1 は、明示的に移行するまでは読み取り専用です。移行ではすべてのエントリーの暗号文を検証し、元のファイルを永続的な .v1-backup として保持するとともに、ローテーションされる .bak も保持します。レガシー形式では、ドメインのメタデータは v1 で認証されていませんでした。そのため、過去に正しかったかどうかを移行によって暗号学的に復元することはできません。以前のバインディングを確認し、承認済みの接続先を個別に設定してください。

侵害されたブローカープロセス、管理者、またはオペレーティングシステムは、このセキュリティ境界の対象外です。悪意のある生成コードには、独立した権限を持つブローカーアカウント／コンテナが必要です。OS の ID を共有してもサンドボックスにはなりません。バックアップ、ロールバック、Windows のアクセス許可、およびリソース制限に関する条件については、脅威モデルを参照してください。

ソースからの検証

Node.js 22 以降を使用してください。ネイティブ統合の完全なテストマトリックスは Python 3.12 でテストされています。依存関係を最小限に抑えたクライアントには、Python 3.10 以降が必要です。

cd platforms/mcp-server
npm ci --ignore-scripts --no-audit --no-fund
npm test
node tests/verify-package.mjs

統合された GitHub ワークフローでは、さらに Python 統合テストを実行し、ビルド済みパッケージをクリーンな環境にインストールして、実際の Docker イメージを起動します。タグ付きリリースの公開には、これらのチェックへの合格が必須です。定期的なメンテナンスタスクや一斉の働きかけは設定されていません。

過去のプラットフォームコード

ブラウザー拡張機能、PWA、ネイティブ GUI／IDE／モバイル用ラッパー、および以前の統合プロトタイプは、過去のソースコードとして引き続き利用できます。これらは Node／Python v3 リリーステストによって認定されておらず、レガシーの v1 ブラウザーストレージは新しい v2 Node 保管庫と互換性がありません。元のファイルは、完全なバージョン管理済みソースアーカイブにも保持されています。プラットフォームの状況では、すべてのフォルダーを完成済みのサポート対象製品として宣伝するのではなく、検証済みのコンポーネントと過去の資料を区別しています。

貢献と引用

CONTRIBUTING.md、CITATION.cff、および統合計画を参照してください。貢献内容は実際の統合ニーズを解決し、再現可能な証拠を含める必要があります。課題を一斉に投稿したり、人為的なエンゲージメントを求めたり、提案を断ったメンテナーに再度連絡したりしないでください。

MIT License。Copyright 2026 Francisco Angulo de Lafuente。