google-admin-mcp

🚀 Google 管理控制台 MCP 服务器

这是一个快速用户目录服务协议（FastMCP）服务器，可借助管理员目录 API 对 Google Workspace 用户进行管理，极大提升用户管理效率。

🚀 快速开始

先决条件

• Docker
• Google Workspace 管理员账号
• 启用了管理员目录 API
• 基于 Base64 的 OAuth2 令牌，存储在 GOOGLE_TOKEN_JSON 环境变量中

安装步骤

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 个字符
  • 包含大写和小写字母
  • 数字
  • 特殊字符
• 服务器需要有效的 OAuth2 令牌，具有适当的管理员目录 API 权限

错误处理

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

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

📄 许可证

本项目采用 MIT 许可证。