Hive Vault

hive-mcp-vault

通过 MCP 访问已确认的 HiveVault FENR 读取数据，以及 AES-256-GCM 加密的条目存储。

实时契约

该服务通过实时 HiveVault 服务提供四个只读 MCP 工具：

工具	实时后端路由
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 Agent 卡片
GET	/.well-known/agent.json	Agent 卡片
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