Google Workspace MCP Server

Google Workspace MCP Server

site icon
2025.04.02 0
JavaScriptGoogle Chat API 集成团队协作管理交流协作
Google_chat_mcp_server 是一个基于 Model Context Protocol (MCP) 的服务,主要用于与 Google Chat API 进行交互。它提供了管理消息、空间和成员关系的工具,支持通过 MCP 接口以编程方式管理 Google Chat 中的各种操作。
View on GitHub

Overview

基本能力

产品定位

Google_chat_mcp_server 是一个用于与 Google Chat API 交互的 MCP 服务,旨在通过编程方式管理 Google Chat 中的消息、空间和成员关系。

核心功能

  1. 消息管理
  2. 发布文本消息到 Google Chat 空间
  3. 获取消息详情
  4. 列出空间中的消息(支持过滤)

  5. 空间管理

  6. 获取空间详情
  7. 列出已加入的空间

  8. 成员管理

  9. 列出空间中的成员
  10. 获取成员详情

  11. 自然语言过滤

  12. 将自然语言查询转换为 API 过滤字符串

适用场景

  • 自动化团队协作消息发布
  • 批量管理 Google Chat 空间和成员
  • 集成 Google Chat 功能到其他应用程序

工具列表

  1. post_text_message:发布文本消息到指定空间
  2. fetch_message_details:获取特定消息的详细信息
  3. list_space_messages:列出空间中的消息(支持分页和排序)
  4. fetch_space_details:获取空间的详细信息
  5. list_joined_spaces:列出用户已加入的所有空间
  6. list_space_memberships:列出空间中的所有成员
  7. fetch_member_details:获取特定成员的详细信息
  8. apply_natural_language_filter:将自然语言查询转换为 API 过滤字符串

常见问题解答

  1. 认证问题
  2. 确保所有必需的 OAuth 范围已授权
  3. 验证客户端 ID 和密钥是否正确
  4. 检查刷新令牌是否有效

  5. API 错误

  6. 检查 Google Cloud Console 中的 API 配额和限制
  7. 确保项目已启用相关 API
  8. 验证请求参数是否符合要求格式

使用教程

使用依赖

  1. Node.js:安装 Node.js 14 或更高版本
  2. Google Cloud Console 设置
  3. 访问 Google Cloud Console
  4. 创建新项目或选择现有项目
  5. 启用 Google Chat API
  6. 设置 OAuth 2.0 凭据

安装教程

  1. 通过 Smithery 安装:
npx spinai-mcp install @KaranThink41/google_chat_mcp_server --provider smithery --config '{"spaceId":"your_space_id","googleClientId":"your_google_client_id","googleClientSecret":"your_google_client_secret","googleRefreshToken":"your_google_refresh_token"}'
  1. 本地开发(可选):
git clone https://github.com/KaranThink41/Google_chat_mcp_server.git
cd Google_chat_mcp_server
npm install
npm run build
node build/index.js

调试方式

  1. 获取刷新令牌:
cp temp-credentials.json.example temp-credentials.json
node get-refresh-token.js
  1. 测试消息发布:
{
  "method": "tools/call",
  "params": {
    "name": "post_text_message",
    "arguments": {
      "spaceId": "AAAAfkdUqxE",
      "text": "Hello, this is a test message!"
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。