内容
<!-- ./agentvalet-readme-header.svg : replace with the promo architecture banner image -->
<p align="center">
<img src="./agentvalet-readme-header.svg" alt="AgentValet" width="100%" />
</p>
<p align="center">
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-server-blue" alt="MCP 服务器"></a>
<img src="https://img.shields.io/badge/IETF-AIMS_aligned-1f6feb" alt="IETF AIMS 对齐">
<img src="https://img.shields.io/badge/identity-SPIFFE-555" alt="SPIFFE 身份">
<img src="https://img.shields.io/badge/registration-RFC_7591-555" alt="RFC 7591">
<img src="https://img.shields.io/badge/authorization-AuthZEN_1.0-555" alt="AuthZEN 1.0">
<img src="https://img.shields.io/badge/license-MIT-green" alt="MIT 许可证">
</p>
# AgentValet
AI 代理的身份和凭证治理代理，为 AI 代理和 MCP 服务器提供服务。它为每个代理提供其自己的加密身份，为每个平台提供范围和短期的凭证，提供人工审批关卡，并记录所有操作。
**开放核心。** 该存储库包含开放源代码的 MIT 许可的客户端界面：MCP 服务器、CLI、Claude Desktop 捆绑包和运行时适配器。托管代理运行凭证保险库、策略引擎和审计存储。自托管代理参考正在规划中。
<!-- TODO: add the awesome-mcp-servers listing link once the PR is merged: https://github.com/punkpeye/awesome-mcp-servers/pull/{{PR_NUMBER}} -->
访问 [agentvalet.ai](https://agentvalet.ai) 即可使用。文档位于 [docs.agentvalet.ai](https://docs.agentvalet.ai)。
## 快速入门
```bash
npx @agentvalet/register
```
这将为您的代理生成一个 RS256 密钥对，注册它，并配置好设置。私钥永远不会离开您的机器。从那时起，您的代理为每个请求签署一个短期的 JWT，并通过 AgentValet 代理调用平台。在仪表盘中批准代理，授予它范围，您就可以运行了。
## 用作 MCP 服务器
`npx @agentvalet/register` 会为您在客户端的 MCP 配置中写入此块。要手动配置 - 在 Claude Desktop、Claude Code、Cursor 或任何 MCP 兼容的客户端中 - 添加：
```json
{
"mcpServers": {
"agentvalet": {
"command": "npx",
"args": ["-y", "@agentvalet/mcp-server"],
"env": {
"AGENT_ID": "agt_your_agent_id",
"OWNER_ID": "your_owner_id",
"PROXY_URL": "https://api.agentvalet.ai",
"AGENT_PRIVATE_KEY_PATH": "~/.agentvalet/agent.key"
}
}
}
}
```
服务器暴露七种工具：`list_platforms`、`use_platform`、`authzen_evaluate`、`agent_register`、`agent_status`、`list_my_pending_actions` 和 `report_self_diagnostic`。私钥从 `AGENT_PRIVATE_KEY_PATH` 读取，永远不会离开您的机器；每个平台调用都通过代理进行范围检查、审计日志和人工审批。
## 问题：凭证继承
凭证继承是指 AI 代理使用您的凭证而不是其自己的凭证时发生的情况。当令牌出现在 `.mcp.json` 或环境变量中时，该项目中的每个代理都继承该令牌的全部范围。它可以执行您可以在每个平台上执行的操作，并且没有任何记录记录哪个代理执行了什么操作。
| 房门钥匙代理（今天的默认） | 代客钥匙代理（AgentValet） |
|-----------------------------------|------------------------------|
| 持有您的真实令牌 | 持有短期签名的令牌，从不持有您的凭证 |
| 在令牌到达的每个平台上具有完全范围 | 限定为您授予的精确操作 |
| 泄露的配置泄露所有内容 | 泄露的配置不会泄露任何可重用的内容 |
| 没有记录哪个代理执行了什么操作 | 每个调用都归因于一个代理身份 |
| 撤销意味着在所有地方旋转令牌 | 一次撤销，立即，无需旋转 |
## 工作原理
```
代理（持有其 RS256 私钥）
|
| 为每个请求签署 60 秒的 JWT
v
+-------------------------------------------+
| AgentValet 代理 |
| 1. 验证 JWT 签名 |
| 2. 检查范围授予（默认为拒绝） |
| 3. 扫描请求中是否有泄露的机密 |
| 4. AuthZEN 策略评估 |
| 5. 人工审批关卡（如果需要） |
| 6. 在内存中注入真实凭证 |---> SaaS 平台
| 7. 追加审计日志条目 |
+-------------------------------------------+
|
v
仪表盘：批准注册、管理范围、查看审计日志、监控使用情况
MCP 服务器：为 Claude 和任何 MCP 兼容的代理公开 AgentValet 工具
```
凭证使用信封加密：每个凭证的唯一 AES-256 数据密钥，由 Key Vault HSM 持有的主密钥封装，在调用时在内存中解密，绝不写入日志。
## 功能
- 每个代理的 RS256 加密身份，SPIFFE 格式的 URI，60 秒签名的 JWT
- 默认拒绝范围，粒度为每个代理、每个平台、每个操作的授予
- 人工审批关卡，用于破坏性或财务范围，一键魔术链接
- 不可变、追加审计日志，可过滤和导出
- 三次电路中断，自动暂停异常代理
- 原生 MCP 服务器和单命令 CLI
- 可自我托管：PostgreSQL 支持，在您自己的基础设施上运行
- 标准对齐：SPIFFE、RFC 7591 动态客户端注册、AuthZEN 1.0、IETF AIMS
## AgentValet 比较
诚实的框架。这些是强大的工具，从相邻的起点实现了代理治理。
| | AgentValet | Aembit | Akeyless | Infisical Agent Vault |
|---|---|---|---|---|
| 起始点 | 代理优先的身份和治理 | 工作负载身份 | 机密管理 | 机密保险库 |
| 所在位置 | 身份层凭证代理 | 工作负载附近的边缘代理 | 网络中的网关 | 网络层转发代理 |
| 入门 | 自助服务，5 分钟内 | 企业销售主导 | 企业销售主导 | 自托管或云 |
| 开源 | 开放核心，MIT* | 否 | 否 | 核心开源 |
| 优势 | AIMS 对齐、审批关卡、审计、廉价入口 | 基于证明的身份 | 分布式片段加密 | 网络级拦截 |
\* 客户端界面（MCP 服务器、CLI、捆绑包、适配器）在此存储库中为 MIT 许可证。代理是托管服务，自我托管参考正在规划中。
如果您已经在企业规模上运行 Aembit 或 Akeyless，AgentValet 并不试图取代您的身份提供商。如果您是今天正在交付代理的开发人员或小型团队，AgentValet 是为您的。
## 路线图和已知限制
公开构建，因此粗糙的边缘在此列出而不是被发现。
**当前已知限制**
- 审批状态的 SSE 流可能会在长时间等待时过早关闭。计划了重新连接逻辑。
- CLI 速率限制是基本的。
- 目前没有过期待处理注册的清除或删除 UI。
**路线图上**
- 代理的自我托管参考（开放的客户端界面已经可以在任何地方运行）
- 审计日志的 SIEM 导出（企业）
- 多区域自我托管指南
- 自定义集成 UI（今天这些是通过路线图系统请求的）
- PII 处理第 2 阶段：代理层检测
## 什么是开放的，什么是托管的
此存储库中开源，MIT 许可证：MCP 服务器、`@agentvalet/register` CLI、Claude Desktop 捆绑包、运行时适配器和 `@agentvalet/mcp-broker`。
两个 MCP 包是彼此的镜像：`@agentvalet/mcp-server` 允许代理通过 AgentValet 代理调用平台，而 `@agentvalet/mcp-broker` 允许您将 AgentValet 策略和凭证强制执行嵌入到您自己的 MCP 服务器中，具有有用的本地模式和零所需帐户。
托管服务今天：持有凭证保险库、运行策略引擎和写入审计日志的代理。代理的自我托管参考正在规划中。有关开放包的本地开发，请参见 `CONTRIBUTING.md`。
## 安全
发现漏洞？请私下报告，参见 `SECURITY.md`。请勿为安全报告开启公共问题。
## 许可证
MIT。参见 `LICENSE`。
