keymaster-mcp

Name: keymaster-mcp
Author: AInoAKARI

本地服务

github.com/AInoAKARI安全16 周前更新

代码仓库

关于 keymaster-mcp

Keymaster MCP 是面向自主 AI Agent 的 Vault 凭据状态桥接服务，让 Agent 检查获准凭据是否可用，而不向模型返回凭据值。它还提供支持服务与密钥名发现、健康检查和安全轮换指引。

主要功能

01检查凭据可用状态而不返回值
02发现支持的服务与密钥名
03仅以元数据列出获准路径
04上游凭据健康检查
05提供安全轮换指引

适用场景

01Agent 在执行操作前确认凭据可用
02查看获准凭据路径而不暴露值
03排查上游凭据状态或规划轮换

MCP 相关

MCP 服务通过工具向客户端提供非披露式 Vault 凭据状态查询。原始凭据不会出现在模型可见的 MCP 输出中。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ainoakari-keymaster": {
      "command": "npx",
      "args": [
        "-y",
        "@akari-os/keymaster-mcp"
      ],
      "env": {
        "USER_KEYMASTER_URL": "<USER_KEYMASTER_URL>",
        "USER_KEYMASTER_TOKEN": "<USER_KEYMASTER_TOKEN>"
      }
    }
  }
}

启动命令npx -y @akari-os/keymaster-mcp

需要配置的环境变量

USER_KEYMASTER_URL密钥Keymaster proxy URL

USER_KEYMASTER_TOKEN密钥Bearer token for Keymaster authentication

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@akari-os/keymaster-mcp1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
service	string	是	服务名称（例如 'openai'、'stripe'、'groq'）
key_name	string	否	键字段名称（默认：'api_key'）

详细介绍

Keymaster MCP

为人类与 AI 团队构建的信任基础设施。

日本語 · 五分钟演示 · 采用指南 · 理念 · 威胁模型

Keymaster 让 Agent 能够发现已获批准的能力是否存在，以及凭据是否正常，而不会将生产凭据返回给模型。配套的 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 部署、付费服务或真实凭据。

此演示是可执行的说明，并非生产代理。

两个公开入口

1. 验证 AI 结果是否属实

通过 Codex 安装公开的 outcome-contract skill：

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

在接受诸如已完成、已发布、已付款、已采用、已交付、节省时间、降低成本、消除风险或收到收件人回复等声明之前，请使用它。

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

单凭提交记录、部署、注册表条目、HTTP 200、自检、自行付款、内部 Agent 调用或执行者自我报告，都不算作外部结果。

2. 在不泄露凭据的情况下检查凭据能力

@akari-os/keymaster-mcp 是面向自主 AI Agent 的非披露型 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

信任模型

具备能力，但不持有凭据

模型可以了解有哪些可用能力，以及这些能力是否可用。可信工作负载会在边界之后使用凭据；模型永远不会收到原始值。

基于证据建立信任

Agent 可以执行操作，但不会将其自己的完成消息视为外部价值的证明。

将理念落实为协议

这些价值观通过系统行为实现：非披露型 MCP 输出、限定范围的读取权限、分离的写入路径、唯一事实来源、受限的网络调用、证据边界，以及明确的后续验证操作。

从演示到实际采用

运行零密钥演示；
在 Vault 中注册一个低风险凭据；
将 Keymaster 与只读主机密钥绑定连接；
让 Agent 通过 secret_status 验证可用性；
在可信工作负载边界内执行经过身份验证的操作；
在验收边界应用 Outcome Contract；
保留证据包和结果回执。

有关准确的验收边界，请参阅采用指南。

成功不只是完成安装。成功意味着省去一个人工步骤、封堵一条泄漏路径、完成一项义务、节省时间、避免成本、消除风险，或获得独立确认的价值。

已在真实工作流中使用？请提交一份真实应用报告，并附上经过脱敏的证据标记以及明确的真实性边界。切勿包含凭据、Bearer 令牌、私有 URL、个人数据或机密证据。

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

稳定版 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 Agent 发现

AI Agent 入口：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 许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。