AgentValet 是一个面向 AI 智能体与 MCP（Model Context Protocol）服务器的身份与凭证治理代理（Identity and credential governance broker）。它旨在解决“凭证继承”问题：当 AI 智能体直接使用你的凭证运行时，任何落入 .mcp.json 或环境变量的令牌都会被项目中的所有智能体继承，从而获得该令牌的全部权限，且无法追溯是哪个智能体执行了操作。AgentValet 为每个智能体提供独立的加密身份、按平台限定范围且短时效的凭证、对关键操作的人工审批门，以及不可篡改的审计日志。
主要能力：
- 每个智能体拥有独立的 RS256 加密身份，采用 SPIFFE 格式 URI，并签发 60 秒有效期的签名 JWT。
- 默认拒绝的权限范围，支持按智能体、按平台、按操作的细粒度授权。
- 对破坏性或涉及财务的操作设置人工介入审批，支持一键魔法链接。
- 不可篡改、仅追加的审计日志，可过滤和导出。
- 三振出局熔断机制，自动暂停行为异常的智能体。
- 原生 MCP 服务器，并提供一条命令即可使用的 CLI。
- 凭证采用信封加密：每个凭证使用唯一的 AES-256 数据密钥，由 Key Vault HSM 中的主密钥封装，仅在调用时在内存中解密，绝不写入日志。
- 符合相关标准：SPIFFE、RFC 7591 动态客户端注册、AuthZEN 1.0、IETF AIMS。
使用方式： 通过 npx @agentvalet/register 命令可为智能体生成 RS256 密钥对、完成注册并自动配置。私钥始终保留在本地机器上。此后智能体每次请求都会签署一个短时效 JWT，并通过 AgentValet 代理调用平台。在仪表板中批准智能体并授予权限范围后即可运行。
作为 MCP 服务器使用时，npx @agentvalet/register 会自动将配置块写入客户端的 MCP 配置。也可手动在 Claude Desktop、Claude Code、Cursor 或任何兼容 MCP 的客户端中添加配置。该服务器暴露七个工具：list_platforms、use_platform、authzen_evaluate、agent_register、agent_status、list_my_pending_actions 和 report_self_diagnostic。私钥从 AGENT_PRIVATE_KEY_PATH 读取，绝不离开本地机器；每次平台调用都经过代理，并执行范围检查、审计日志记录以及对关键操作的人工审批。
开源与托管： 本仓库中的开源部分（MIT 许可）包括 MCP 服务器、@agentvalet/register CLI、Claude Desktop 捆绑包、运行时适配器以及 @agentvalet/mcp-broker。两个 MCP 包互为镜像：@agentvalet/mcp-server 让智能体通过 AgentValet 代理调用平台；@agentvalet/mcp-broker 则允许在你自己的 MCP 服务器中嵌入 AgentValet 的策略与凭证执行，提供实用的本地模式且无需账户。托管服务目前包括持有凭证保险库、运行策略引擎和写入审计日志的代理；代理的自托管参考已在路线图中。
适用场景： 适合正在开发或部署 AI 智能体的开发者和小型团队，尤其是需要为智能体提供独立身份、细粒度权限控制、人工审批和审计追踪的场景。如果企业已大规模使用 Aembit 或 Akeyless 等身份提供商，AgentValet 并非要替代它们。
已知限制：
- 审批状态的 SSE 流在长时间等待时可能提前关闭，重连逻辑已在计划中。
- CLI 的速率限制较为基础。
- 尚无用于清除或删除过期待处理注册的界面。
- 代理的自托管参考、审计日志的 SIEM 导出（企业版）、多区域自托管指南、自定义集成界面、PII 处理第二阶段（在代理层检测）均在路线图中。
安全报告请私下提交，参见 SECURITY.md，不要公开 issue。
