Google Admin MCP 服务器

这是一个通过Admin Directory API管理Google Workspace用户的FastMCP服务器。

功能

• 列出域中的用户
• 使用安全随机密码创建新用户
• 获取详细的用户信息
• 暂停和恢复用户

预备条件

• Docker
• Google Workspace 管理员账户
• 启用Google Admin Directory API
• 在GOOGLE_TOKEN_JSON环境变量中使用Base64编码的OAuth2令牌

安装

1. 克隆仓库
2. 构建Docker镜像：

docker build -t google-admin-mcp .

运行服务器

运行容器：

docker run -e GOOGLE_TOKEN_JSON="your_base64_encoded_token" google-admin-mcp

可用工具

listUsers

列出域中的用户。

{
  "domain": "yourdomain.com"
}

addUser

使用安全随机密码创建新用户。

{
  "primaryEmail": "user@yourdomain.com",
  "firstName": "First",
  "lastName": "Last"
}

getUser

获取特定用户的详细信息。

{
  "userKey": "user@yourdomain.com"
}

suspendUser

暂停用户账户。

{
  "userKey": "user@yourdomain.com"
}

unsuspendUser

恢复用户账户。

{
  "userKey": "user@yourdomain.com"
}

安全说明

• 所有创建的用户在首次登录时都需要更改密码
• 密码安全生成，包含：
  • 至少12个字符
  • 大小写字母
  • 数字
  • 特殊字符
• 服务器需要一个具有适当Admin Directory API范围的有效OAuth2令牌

错误处理

服务器提供清晰的错误消息，包括：

• 认证失败
• 参数无效
• API错误
• 缺失环境变量

许可证

MIT许可证