AI导哈

API密钥管理服务器

Keymaster-MCP-Server是一个基于HashiCorp Vault的安全API密钥管理代理服务器，遵循'服务持有票据而非秘密'的架构，确保应用程序在运行时动态获取密钥而非存储原始API密钥。

  • by AInoAKARI
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AInoAKARI/keymaster-mcp-server

使用说明

密钥管理器mcp服务器

MCP（模型上下文协议）服务器 钥匙大师 -由HashiCorp Vault支持的安全API密钥管理代理。

Keymaster遵循“服务持有票证，而不是秘密”架构：您的应用程序从不存储原始API密钥。相反，它们只持有Keymaster身份验证令牌，并在运行时获取机密。

安装

npm install -g keymaster-mcp-server

或者直接使用npx运行：

npx keymaster-mcp-server

配置

环境变量

变量 必填 描述
KEYMASTER_BASE_URL 是 密钥管理员代理URL（例如。 https://your-keymaster.onrender.com)
KEYMASTER_AUTH_TOKEN 是 Keymaster身份验证的承载令牌
VAULT_ADDR 否 HashiCorp保险库URL--仅需要 list_api_keys
VAULT_TOKEN 否 保险库访问令牌--仅需要 list_api_keys
VAULT_MOUNT 否 Vault KV v2装载名称（默认值： akarihearts-v2)

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "keymaster": {
      "command": "npx",
      "args": ["-y", "keymaster-mcp-server"],
      "env": {
        "KEYMASTER_BASE_URL": "https://your-keymaster.onrender.com",
        "KEYMASTER_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

要启用密钥列表（需要直接访问Vault），请执行以下操作：

{
  "mcpServers": {
    "keymaster": {
      "command": "npx",
      "args": ["-y", "keymaster-mcp-server"],
      "env": {
        "KEYMASTER_BASE_URL": "https://your-keymaster.onrender.com",
        "KEYMASTER_AUTH_TOKEN": "your-auth-token",
        "VAULT_ADDR": "https://your-vault.onrender.com",
        "VAULT_TOKEN": "your-vault-token"
      }
    }
  }
}

工具

get_api_key

从保管库中检索API密钥。

参数 类型 默认值 说明
api_name 字符串 （必填） 服务名称（例如。 openai, groq, stripe)
key_name 字符串 api_key 关键字段名称

list_api_keys

列出vault中已注册的秘密路径。只返回名称，从不返回值。

需要 VAULT_ADDR 和 VAULT_TOKEN 环境变量。

参数 类型 默认值 说明
path 字符串 （根） 列表的子路径（例如。 api_keys)

check_key_health

检查特定的API密钥是否存在并且可以检索。

参数 类型 默认值 说明
api_name 字符串 （必填） 服务名称
key_name 字符串 api_key 关键字段名称

建筑

Claude / AI Agent
       │
       ▼
  keymaster-mcp  (this server, MCP protocol over stdio)
       │
       ▼
   Keymaster     (read-only proxy, Bearer auth)
       │
       ▼
  HashiCorp Vault (KV v2 secrets engine)

安全

  • 从不硬编码 代码库中的API密钥或令牌。始终使用环境变量。
  • KEYMASTER_AUTH_TOKEN 是一个“票证”——它授予对Keymaster代理的访问权限，但本身不包含秘密。
  • 这 get_api_key 该工具返回原始秘密值。确保您的MCP客户端安全地处理它们，并且不会记录它们。
  • list_api_keys 需要直接访问保险库(VAULT_TOKEN).仅将此权限授予受信任的环境。
  • 钥匙大师遵循 “服务持有门票，而不是秘密” 图案：旋转 KEYMASTER_AUTH_TOKEN 而不接触单个API键。

许可证

麻省理工学院

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

相关 MCP