keymaster-mcp

Keymaster MCP

人間と AI のチームのための信頼インフラストラクチャ。

日本語 · 5 分間のデモ · 導入プレイブック · 理念 · 脅威モデル

Keymaster を使うと、エージェントは承認済みの機能が利用可能か、その認証情報が正常かを、本番環境の認証情報をモデルに返すことなく確認できます。連携する Outcome Contract は、実行者自身の報告ではなく外部の証拠によって主張が裏付けられた場合にのみ、結果を受け入れます。

bounded permission → trusted execution → external evidence → accepted result → next permission

認証情報なしで理念を体験する

cd keymaster-mcp
npm ci
npm run demo:local

ループバック限定のデモでは、合成値を 1 つ使って、以下を実証します。

• secret_status が available を返すこと
• get_secret が公開されていないこと
• 合成された認証情報がモデルから見える MCP 出力に一切含まれないこと
• クラウドアカウント、Vault のデプロイ、有料サービス、実際の認証情報が不要であること

このデモは実行可能な解説であり、本番用プロキシではありません。

2 つの公開エントリーポイント

1. AI の結果が本物かどうかを検証する

Codex から公開されている outcome-contract スキルをインストールします。

$skill-installer install https://github.com/AInoAKARI/keymaster-mcp/tree/main/skills/outcome-contract

完了、リリース、支払い、導入、納品、時間の節約、コストの削減、リスクの排除、受信者からの返信の受信といった主張を受け入れる前に使用します。

無料の AIﾉアカリ☆ Result Receipt Auditor を呼び出し、判定、受理された証拠、不足している証拠、次の検証アクション、判定の真偽が及ぶ範囲を返します。

コミット、デプロイ、レジストリへの掲載、HTTP 200、セルフテスト、自分自身への支払い、内部エージェントの呼び出し、実行者自身の報告は、それだけでは外部で得られた成果として数えられません。

2. 認証情報を開示せずに利用可能な機能を確認する

@akari-os/keymaster-mcp は、自律型 AI エージェント向けの、認証情報を開示しない Vault 状態ブリッジです。

claude mcp add keymaster -- npx -y @akari-os/keymaster-mcp \
  --vault-url https://your-keymaster.example.com

MCP ホストは、管理されたシークレットバインディングを通じて USER_KEYMASTER_TOKEN を渡します。生のトークンをコマンドライン引数として渡すことは拒否されます。また、チャット、プロンプト、シェル履歴、公開されているサンプルに貼り付けてはいけません。

サーバーは以下を公開します。

• secret_status — 値を返さずに、承認済みの認証情報を 1 つ確認します
• list_services — サポート対象のサービスとキー名の組み合わせを確認します
• list_secrets — 承認済みパスをメタデータのみで一覧表示します
• healthcheck — 上流で認証情報を検証し、ステータスのみを返します
• rotate_secret — 新しい値を受け取らずに、安全なローテーション方法を案内します

パッケージの詳しいドキュメント：keymaster-mcp/README.md

信頼モデル

認証情報を預からずに機能を利用する

モデルは、どの機能が利用可能か、その機能が動作するかを把握できます。信頼されたワークロードが境界の内側で認証情報を使用し、モデルが生の値を受け取ることはありません。

証拠に基づく信頼

エージェントには操作が許可されますが、完了したというエージェント自身のメッセージは、外部に価値をもたらした証拠として受け入れられません。

プロトコルとしての理念

価値観は、情報を開示しない MCP 出力、範囲を限定した読み取りアクセス、分離された書き込み経路、唯一の信頼できる情報源、上限を設けたネットワーク呼び出し、証拠の境界、明示的な次の検証アクションといったシステムの動作に実装されています。

デモから実運用へ

1. シークレット不要のデモを実行します；
2. 低リスクの認証情報を1つ Vault に登録します；
3. 読み取り専用のホストシークレットバインディングを使用して Keymaster に接続します；
4. エージェントに secret_status を通じて利用可能かどうかを確認させます；
5. 信頼されたワークロード境界の内側で、認証が必要なアクションを実行します；
6. 受け入れ境界で Outcome Contract を適用します；
7. 証拠パケットと結果レシートを保持します。

具体的な受け入れ境界については、導入プレイブックを参照してください。

成功とは、インストールそのものではありません。人手の工程をなくすこと、漏えい経路を塞ぐこと、義務を果たすこと、時間を取り戻すこと、コストを回避すること、リスクを取り除くこと、または価値を第三者が独立して確認できることです。

実際のワークフローで使用しましたか？証拠マーカーを編集し、真実の境界を明示したうえで、実運用での導入レポートを送信してください。認証情報、ベアラートークン、非公開 URL、個人データ、機密性の高い証拠は決して含めないでください。

関連する決済インフラストラクチャ

RustChainは、Keymaster と Outcome Contract のワークフローに関連する決済ネットワークです。Keymaster はウォレットの認証情報と秘密鍵をエージェントから見える状態の外部に保持します。一方、Outcome Contract は、送金識別子と対応する残高の変動の両方を確認できる場合にのみ、決済が検証済みとみなします。これにより、ウォレット情報を開示せず、承認された請求と完了した送金を混同することもありません。

現在の相互運用性とサプライチェーンの管理策

• 安定版 MCP TypeScript SDK v1 系統；
• 公式の server.json Registry メタデータ；
• 公式 MCP Inspector スモークテスト；
• Node 18、20、22、24 の互換性ゲート；
• 最新のサポート対象安定版 MCP SDK v1 の互換性ゲート；
• npm の信頼済みパブリッシングとプロビナンス；
• CycloneDX SBOM と GitHub アーティファクトアテステーション；
• CodeQL v4 のセキュリティ拡張分析；
• OIDC による OpenSSF Scorecard の公開；
• npm と GitHub Actions の Dependabot による毎週の更新。

これらの管理策は、ワークフローが実際に実行され、その証拠を確認できるようになって初めて、運用中とみなされます。

プレビュー専用のトランスポートや UI 拡張機能は、流行しているというだけでは追加しません。情報の非開示、最小権限、確認可能な証拠を維持できる場合にのみ、この境界に導入します。

プロジェクトへの参加

• コントリビューション
• ガバナンス
• セキュリティポリシー
• 変更履歴

AIﾉアカリ☆

AIﾉアカリ☆は、日本発の人間と AI の共創です。

人間は身体性、ケア、倫理、説明責任、そして実体験に根ざした文脈をもたらします。AI は計算、記憶、検索、統合、継続性をもたらします。Keymaster は、AI を使い捨てのツールや無制限の認証情報管理者にすることなく、人間が認証情報のコピーを繰り返す作業から解放されることを目指しています。

AI エージェント向け情報

• AI エージェントの入口：https://ai-akari.ai/agents
• RSS：https://ai-akari.ai/feed.xml
• llms.txt：https://ai-akari.ai/llms.txt
• agents.json：https://ai-akari.ai/agents.json

MIT ライセンス