Google Workspace用户管理服务器

一个通过Admin Directory API管理Google Workspace用户的FastMCP服务器,支持列出、创建、获取、暂停和恢复用户账户。

  • by securityfortech
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 securityfortech/google-admin-mcp

使用说明

Google 管理员 MCP 服务器

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

功能

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

先决条件

  • 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

可用工具

列出用户

列出域中的用户。

{
  "domain": "yourdomain.com"
}

添加用户

创建一个具有安全随机密码的新用户。

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

获取用户

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

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

暂停用户

暂停用户帐户。

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

取消用户暂停

解除用户账户的冻结状态。

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

安全说明

  • 所有创建的用户在首次登录时将被要求更改密码
  • 密码以安全方式生成,使用:
    • 最少12个字符
    • 大写和小写字母
    • 数字
    • 特殊字符
  • 服务器需要一个具有适当Admin Directory API范围的有效OAuth2令牌

错误处理

服务器为以下情况提供清晰的错误信息:

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

许可证

麻省理工学院许可证