🚀 Google 管理控制台 MCP 服务器
这是一个快速用户目录服务协议（FastMCP）服务器，可借助管理员目录 API 对 Google Workspace 用户进行管理，极大提升用户管理效率。
🚀 快速开始
先决条件
- Docker
- Google Workspace 管理员账号
- 启用了管理员目录 API
- 基于 Base64 的 OAuth2 令牌，存储在
GOOGLE_TOKEN_JSON环境变量中
安装步骤
- 克隆仓库
- 构建 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 许可证。