Google Admin MCP 服务器

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

功能特性

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

前提条件

• Node.js >= 20.0.0
• Google Workspace 管理员帐户
• 启用 Google Admin Directory API
• Base64 编码的 OAuth2 令牌，存储在 GOOGLE_TOKEN_JSON 环境变量中

安装

1. 克隆存储库
2. 安装依赖项：

npm install

配置

设置必需的环境变量：

export GOOGLE_TOKEN_JSON="your_base64_encoded_token"

可用工具

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"
}

运行服务器

启动服务器：

npm start

安全注意事项

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

错误处理

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

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

许可证

MIT 许可证