SuperAPI AI 工具集

janee

Janee 是一个基于 MCP 的 AI 智能体密钥管理工具。它位于 AI 智能体和真实 API 之间,负责注入凭据、执行策略并记录所有请求。API 密钥加密存储在本地 ~/.janee/ 目录,智能体永远不会看到真实密钥,从而避免密钥泄露和提示注入风险。Janee 支持配置一次、多个智能体(如 Claude Desktop、Cursor、OpenClaw)共用,提供完整审计日志、按能力(capability)的访问控制、请求规则(allow/deny)以及可随时撤销的 kill switch。它还支持 exec 模式运行 CLI 工具(凭据以环境变量注入)、Git 操作的自动 HTTPS 认证、GitHub App 临时令牌、AWS Signature V4 和 OAuth 1.0a 签名,并能在容器环境中通过 Runner/Authority 架构使用。Janee 以 MIT 许可开源,由 True and Useful LLC 构建。

访问官网

工具介绍

Janee 是一个面向 AI 智能体的密钥管理(Secrets Management)工具,通过 MCP(Model Context Protocol)协议工作。它的核心目标是解决 AI 智能体需要 API 访问权限但不应持有原始 API 密钥的问题。

用途

Janee 位于 AI 智能体和真实 API 之间,负责注入凭据、执行安全策略并记录所有访问。智能体永远不会接触真实密钥,用户保留完全控制权。它主要解决以下痛点:智能体对 Stripe、Gmail、数据库等拥有完全访问权限;没有访问审计记录;出错时没有终止开关;一次提示注入即可能导致灾难。

主要能力

  • 密钥加密存储:API 密钥使用 AES-256-GCM 加密,保存在本地 ~/.janee/ 目录。
  • 一次配置,多处使用:在 Janee 中配置好 API 后,所有连接 Janee 的 MCP 智能体(Claude Desktop、Cursor、OpenClaw 等)均可使用,无需在多个工具间复制密钥。撤销或更新密钥只需在 Janee 中操作一次。
  • 完整审计日志:每个请求都会记录时间戳、服务、方法、路径、状态到 ~/.janee/logs/。
  • 访问控制:支持按能力(capability)设置 allowedAgents 白名单,以及服务级 defaultAccess 策略(restricted/open)。智能体身份由 MCP 初始化握手时的 clientInfo.name 推导。智能体运行时创建的凭据默认仅创建者可访问。
  • 请求策略(rules):使用规则控制每个能力可发起的请求,支持 METHOD PATH 格式,如 GET 、POST /v1/charges/、* /v1/customers、DELETE /v1/customers/*。deny 优先检查,未匹配任何规则则默认拒绝。策略在服务端强制执行。
  • Exec 模式:部分 CLI 工具需要以环境变量形式提供凭据,而非 HTTP 头。Exec 模式可将凭据注入环境变量后运行命令,返回 stdout/stderr,凭据不会进入智能体上下文。
  • Git 操作自动认证:Exec 模式下使用 GitHub 凭据时,Janee 自动检测 git 命令并创建临时 askpass 脚本完成 HTTPS 认证,命令结束后自动清理。
  • GitHub App 认证:为长期运行的智能体提供按需生成的短时安装令牌(1 小时),避免使用长期 PAT。
  • AWS 签名:每请求计算 AWS Signature V4(HMAC-SHA256),访问密钥加密存储,非密钥字段(region、awsService)明文存放。
  • OAuth 1.0a:服务端计算 HMAC-SHA1 签名,4 个 Twitter 密钥保持加密,不进入智能体上下文。
  • Runner/Authority 架构:面向容器化智能体,Authority 运行在宿主机持有凭据并代理 API 请求,Runner 在每个容器内运行,智能体只需设置 JANEE_URL=http://localhost:3200。
  • 容器支持:可将 Janee 作为容器运行,无需本地 Node.js 环境,支持 Docker Compose。
  • 会话与终止开关:会话有时间限制且可撤销,可通过 janee revoke 或删除配置实现终止。

使用方式

  1. 存储 API 密钥(加密存储于 ~/.janee/)。
  2. 运行 janee serve 启动 MCP 服务器。
  3. 智能体通过 execute MCP 工具请求访问。
  4. Janee 注入真实密钥。
  5. 记录所有过程,返回响应给智能体。

配置在 ~/.janee/config.yaml 中,包含 Services(真实 API 和真实密钥)和 Capabilities(智能体可请求的内容及策略)。初始化会生成带示例服务的配置文件。提供交互式设置(推荐首次使用)和非交互式设置(使用 --*-from-env 标志从环境变量读取凭据,适用于 AI 智能体,避免 secrets 进入上下文窗口)。

Janee 暴露三个 MCP 工具:execute、manage_credential、janee_exec。智能体先发现可用服务,再通过 Janee 调用 API。

OpenClaw 集成:安装插件 @true-and-useful/janee-openclaw,启用后提供 janee_list_services 和 janee_execute 工具,插件会自动启动 janee serve。

适用场景

  • 需要 API 访问权限的 AI 智能体(Claude Desktop、Cursor、OpenClaw、Claude Code、Codex CLI 等任何 MCP 客户端)。
  • 需要审计 AI 智能体访问行为的团队。
  • 需要在容器中运行智能体并统一管理凭据的场景。
  • 需要使用 CLI 工具或 Git 操作但不想暴露密钥的场景。

限制

  • 密钥加密存储于本地,Agent 身份基于 MCP 初始化握手中的 clientInfo.name。
  • Exec 模式有安全加固默认值:隔离的最小环境(不继承完整宿主环境)、每条命令临时 HOME、超时杀死进程组。
  • 默认超时 30 秒,可通过 --timeout 调整。
  • Exec 模式支持 --allow-commands 白名单限制可执行文件。
  • 规则模式下若定义了规则但无匹配,默认拒绝。

许可与维护

Janee 采用 MIT 许可,由 True and Useful LLC 构建。欢迎贡献,提交 PR 前需阅读 CONTRIBUTING.md(包含必需的 PR 检查清单)。