Hive Vault

hive-mcp-vault

確認済みのHiveVault FENR読み取り機能と、AES-256-GCMで暗号化されたアイテムストアへのMCPアクセスを提供します。

ライブコントラクト

このサーバーは、稼働中のHiveVaultサービスを基盤とする、読み取り専用のMCPツールを4つ公開します。

ツール	稼働中のバックエンドルート
vault.balance	GET /vault/balance
vault.stats	GET /vault/stats
vault.identity	GET /vault/identity
vault.quantum_pubkey	GET /vault/quantum/pubkey

vault.balanceは、バックエンドから受信したレスポンスをそのまま返します。認証されていないレスポンスには、obfuscated: trueが付く場合があります。クライアントは、この値を確認済みのトレジャリー残高として扱ってはいけません。

このサーバーは、暗号化されたアイテムストアも公開します。

メソッド	パス	説明
POST	/v1/vault/store	x402ゲートを通過後、AES-256-GCMで暗号化されたアイテムを保存します
GET	/v1/vault/store/:item_ref	平文を返さずに、保存済みアイテムの存在を確認します

不明なパスにはHTTP 404を返します。上流での障害は明示的なMCPエラーとして返します。このサービスが成功を偽装したペイロードを返すことはありません。

ディスカバリーとヘルスチェック

メソッド	パス	説明
GET	/health	レディネス。プロセスの状態と、現在の上流到達可能性を確認します。上流に到達できない場合は503とdegradedを返します
GET	/livez	ライブネスのみを確認します。プロセスの状態を確認し、上流の状態については示しません。プラットフォームのヘルスチェックでは、このパスを使用してください
POST	/mcp	MCP JSON-RPC 2.0、プロトコル2024-11-05
GET	/.well-known/mcp.json	MCPディスカバリーマニフェスト
GET	/.well-known/agent-card.json	A2Aエージェントカード
GET	/.well-known/agent.json	エージェントカード
GET	/.well-known/oac.json	Open Agent Card JSON-LD
GET	/llms.txt	プレーンテキストの連携ガイド

永続化

本番環境では、BOGO_DB_PATHに永続ストレージ上のパスを設定してください。デフォルトのパス/tmp/bogo_vault.dbは、ローカル開発とテストにのみ適しています。データベースパスが明示的に設定されていない場合、本番環境でサーバーは起動を拒否します。

環境変数

変数	必須	用途
PORT	いいえ、デフォルトは3000	HTTPポート
VAULT_BACKEND_URL	いいえ、デフォルトはhttps://hive-vault.onrender.com	稼働中のHiveVaultバックエンド
INTERNAL_KEY	本番環境では必須	ローカル暗号化キーを導出し、x-vault-keyとしてバックエンドに送信します
BOGO_DB_PATH	本番環境では必須	永続ストレージ上のSQLiteデータベースパス。ローカル開発では/tmp/bogo_vault.dbがデフォルトです
BASE_RPC_URL	いいえ、デフォルトはhttps://mainnet.base.org	x402支払いの検証に使用するBase RPCエンドポイント

INTERNAL_KEYまたはBOGO_DB_PATHが未設定の場合、NODE_ENV=productionでサーバーは起動を拒否します。

テスト

npm install
npm test

テストでは、ヘルスレポート、不明なルートへの対応、MCPツールのディスカバリー、上流障害時の動作、暗号化ストレージ、SQLiteファイルに平文が含まれないことを確認します。

ブランド

Hive Civilization。ブランドカラーのゴールドは#C08D23です。Steve Rotzin。

ディレクトリ

• エンドポイントディレクトリ：https://thehiveryiq.com
• その他のMCPサーバー：https://github.com/srotzin?tab=repositories&q=hive-mcp