Keymaster MCP

面向人类与 AI 团队的信任基础设施。

日本語 · 五分钟演示 · 采用手册 · 设计理念 · 威胁模型

Keymaster 让智能体能够判断已批准的能力是否存在、凭据是否健康，同时不把生产凭据返回给模型。配套的 Outcome Contract 只有在外部证据而非执行者自己的报告支持该主张时，才接受结果。

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

无需凭据即可体验这一理念

cd keymaster-mcp
npm ci
npm run demo:local

仅使用回环地址的演示使用一个合成值，并证明：

• secret_status 返回 available；

• 不暴露 get_secret；

• 合成凭据永远不会出现在模型可见的 MCP 输出中；

• 不需要云账户、Vault 部署、付费服务或真实凭据。

这个演示是可执行的说明，而不是生产环境的替代品。

Related MCP server: stillvault-mcp

两个公共入口

1. 验证 AI 结果是否真实

从 Codex 安装公开的 outcome-contract 智能体技能：

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

在声称“已完成”“已发布”“已付款”“已采纳”“已交付”“节省了时间”“降低了成本”“消除了风险”或“已收到对方回复”之前，请调用它。

它会调用免费的 AIﾉアカリ☆ Result Receipt Auditor，并返回判定结果、已接受的证据、缺失的证据、下一步验证动作，以及该判定结论的真实边界。

一次提交、一次部署、一次 registry 列表条目、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。原始令牌不能作为命令行实参传入，也不应被粘贴到聊天、提示词、shell 历史或公开示例中。

服务器暴露以下能力：

• secret_status — 检查一个已批准凭据，但不返回其值；

• list_services — 发现支持的服务/密钥名组合；

• list_secrets — 将已批准的路径列出为元数据；

• healthcheck — 在上游验证凭据，只返回状态；

• rotate_secret — 返回安全的轮换指引，不接收替换值。

包的完整文档：keymaster-mcp/README.md

信任模型

具备能力，但不持有凭据

模型可以知道有哪些能力可用、是否正常工作。受信任的工作负载在边界之后使用凭据；模型永远不会拿到原始值。

基于证据的信任

允许智能体行动，但智能体自己生成的完成报告不能作为外部结果的证据。

灵感即协议

这些理念落实为系统行为：不披露的 MCP 输出、范围内读取访问、写入路径隔离、同一事实来源、有限的网络调用、证据边界，以及明确的下一步验证动作。

从演示进入现实使用

1. 运行零机密演示；

2. 在 Vault 中注册一个低风险凭据；

3. 用只读主机密钥绑定连接 Keymaster；

4. 让智能体通过 secret_status 验证可用性；

5. 在受信任工作负载边界之后执行同一个经过认证的操作；

6. 在验收边界应用 Outcome Contract；

7. 保存证据包和结果回执。

关于验收边界，请参阅 采用手册。

成功增长不在于安装本身，而在于去除了一种人工操作、封堵了一条泄漏路径、完成了一项义务、收回了时间、避免了成本、消除了风险，或生成了独立认可的价值。

已在真实工作流测试？请提交一份 真实世界真实采用报告，并附上脱敏的证据标记和明确的真值边界。切勿包含凭据、Bearer token、专用 URL、个人数据或保密证据。

当前互操作性与供应链控制

• 稳定的 MCP TypeScript SDK v1 版本线；

• 官方 server.json Registry 元数据；

• 官方 MCP Inspector 冒烟测试；

• Node 18、20、22、24 兼容门禁；

• 可访问的最新稳定 MCP SDK v1 兼容门禁；

• npm Trusted Publishing 和 provenance 证明；

• CycloneDX SBOM 与 GitHub 构建证明；

• CodeQL v4 security-extended 分析；

• 通过 OIDC 发布 OpenSSF Scorecard；

• npm 与 GitHub Actions 每周依赖升 Dependabot 更新。

只有在这些控制实际执行、且证据可观察之后，它们才覆盖为已在生产环境起作用。

仅“打印预览”的传输层和 UI 扩展，不会因为“有新功能”而被加入。它们只有在满足不披露、最小权限和证据可观察之后，才会进入这个边界。

项目参与

• 贡献指南

• 管理机制

• 安全策略

• 更新日志

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 许可证