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 許可證。