anthropic-admin-mcp

anthropic-admin-mcp

Anthropic 尚未推出的 MCP 服务——全面覆盖 Anthropic Admin API 和 Usage & Cost API，类型定义完善、工具齐全，并严格限定安全范围。

使用自然语言，通过任何兼容 MCP 的客户端（Claude Desktop、Cursor、Windsurf、ChatGPT 等）管理你的 Anthropic 组织：

• “我的组织上周按工作区分组的支出是多少？”
• “昨天哪个 API 密钥消耗的 Opus 令牌最多？”
• “显示 Pre-Mortem 过去 14 天逐日的用量。”
• “邀请 [email protected] 作为开发者加入 Sandbox 工作区。”
• “停用名为 'old-laptop' 的 API 密钥。”

10 个读取工具、10 个写入工具、审计日志、可选的工作区范围限制、只读模式、角色升级防护。

为什么要开发这个项目

Anthropic 提供了出色的 Admin API，包含约 22 个端点，涵盖组织管理、工作区、成员、API 密钥、用量报告和成本报告。第三方现有的 MCP 封装通过商业集成平台仅覆盖了其中很小一部分。本服务是原生、免费、开源且完整的——只需两分钟即可使用你自己的 Admin 密钥完成安装。

安装

pip install git+https://github.com/Trushtonfactory/anthropic-admin-mcp.git

或者用于本地开发：

git clone https://github.com/Trushtonfactory/anthropic-admin-mcp.git
cd anthropic-admin-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

配置

1. 在 console.anthropic.com → Settings → Admin Keys 获取 Admin API 密钥。 需要 Organization 计划（Team / Pro+ / Enterprise）和管理员角色。个人账户无法创建 Admin 密钥。

2. 将 .env.example 复制为 .env，并填入你的密钥：

   cp .env.example .env
   # edit .env: ANTHROPIC_ADMIN_KEY=sk-ant-admin-...
   

3. 将其接入你的 MCP 客户端。对于 Claude Desktop，将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

   {
     "mcpServers": {
       "anthropic-admin": {
         "command": "anthropic-admin-mcp",
         "env": {
           "ANTHROPIC_ADMIN_KEY": "sk-ant-admin-..."
         }
       }
     }
   }
   

   更多选项（只读模式、工作区范围限制）请参阅 examples/claude_desktop_config.json。

工具

读取（10 个）

工具	用途
get_org_info	测试密钥；返回组织 ID 和名称
list_members	列出组织成员及其角色
list_invites	列出待处理和历史邀请
list_workspaces	列出活跃工作区（以及可选的已归档工作区）
get_workspace	将工作区 ID 解析为完整记录
list_workspace_members	列出特定工作区的成员
list_api_keys	列出密钥，可按状态 / 工作区筛选
get_usage_report	令牌用量，按工作区 / api_key / 模型等分组
get_cost_report	金额成本，按工作区 / 描述分组
get_claude_code_usage	Claude Code 专属用量数据

写入（10 个）——均需 confirm=True

工具	操作
invite_member	发送邀请（无法授予管理员权限）
delete_invite	取消待处理的邀请
update_member_role	更改成员的组织角色（无法操作管理员）
remove_member	移除非管理员成员
create_workspace	创建新工作区
update_workspace	重命名工作区或更改其颜色
archive_workspace	归档工作区
add_workspace_member	授予工作区访问权限
update_workspace_member_role	更改工作区角色
remove_workspace_member	撤销工作区访问权限
update_api_key	重命名或停用 API 密钥

运行

# Full mode (read + write), stdio transport
anthropic-admin-mcp

# Read-only — recommended for first-time setup
anthropic-admin-mcp --read-only

# Streamable HTTP (for remote MCP clients)
anthropic-admin-mcp --http --port 8000

# Restrict writes to specific workspaces (set in .env or shell)
ALLOWED_WORKSPACES=wrkspc_abc,wrkspc_xyz anthropic-admin-mcp

安全

完整的威胁模型和设计说明，请参阅 SECURITY.md。简而言之：

• 读取不受限制。 Admin API 使用你的密钥可访问的所有内容，本服务都能访问。
• 写入受到保护。 每项修改操作都需要 confirm=True，会记录到 JSONL 审计日志，并遵守可选的工作区范围限制。
• 客户端会阻止角色升级，尽管 API 本身也会在服务端阻止此操作——这样 Claude 能收到更清晰的错误消息。
• 不存在凭据外泄路径。 Admin API 永远不会返回密钥值，本服务也永远不会记录 Admin 密钥本身。

状态

v0.1.0 — 读写工具接口已完整实现。分页、错误消息和审计日志均已手动测试。目前尚未实现使用限制。Pydantic 响应模型较为精简（工具会返回原始字典）。

欢迎提交 Issue 和 PR。

许可证

MIT — 详见 LICENSE。