AI导哈

聊天协议服务器

基于Google Chat API的MCP服务器，支持消息收发、空间和成员信息获取。

  • by CHIHI913
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 CHIHI913/google-chat-mcp

使用说明

谷歌聊天MCP服务器

是利用谷歌Chat API的MCP（Model Context Protocol）服务器。 可以收发消息，获取空间成员信息。

机能

空间关系

  • list_spaces -获取参与空间列表
  • get_space -获取空间详细信息

成员关系

  • list_members -获取空间中的成员列表

消息关系

  • list_messages -获取空间中的消息列表
  • get_message -获取消息详细信息
  • create_message -发送消息
  • update_message -更新消息
  • delete_message -删除消息

安装，安装

1.设置谷歌Cloud Project

  1. 谷歌云控制台 访问
  2. 创建新项目（或选择现有项目）
  3. “API和服务”→“库” 谷歌聊天API 启用

2.OAuth同意画面的设定

  1. “API和服务”→“OAuth同意画面”
  2. 选择用户类型（内部或外部）
  3. 输入应用程序名称、用户支持邮件、开发商联系人
  4. 添加范围：
    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.memberships.readonly
    • https://www.googleapis.com/auth/chat.messages

3.OAuth客户端ID的创建

  1. API和服务-凭据
  2. “创建凭据”→“OAuth客户机标识”
  3. 应用程序类型： 网络应用程序
  4. 输入名称
  5. 已批准的重定向URI: http://localhost:8080/callback 添加
  6. 创建-下载JSON

4.Chat App的设置（必需）

  1. “API和服务”→“有效的API和服务”→“谷歌Chat API”
  2. 打开配置选项卡
  3. 设置：
    • 应用程序名称：任意名称
    • 头像URL：任何图像URL（必需）
    • 说明: 任意
    • 接続设定：选择“HTTP端点URL”https://example.com 输入（实际不使用）
    • 公开设定：选择内部或特定用户
  4. 单击保存

5.信贷配置

mkdir -p credentials
# ダウンロードした JSON を配置
mv ~/Downloads/client_secret_*.json credentials/client_secret.json

6.安装和构建依赖关系

pnpm install
pnpm run build

使用方法

MCP设定

.mcp.json 将添加到项目根目录或Claude Code设置中：

{
  "mcpServers": {
    "google-chat": {
      "command": "node",
      "args": ["/path/to/google-chat-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/google-chat-mcp/credentials/client_secret.json",
        "TOKEN_PATH": "/path/to/google-chat-mcp/credentials/token.json"
      }
    }
  }
}

初回认证

首次启动时浏览器打开，要求用谷歌账户进行认证。 认证完成后，标记 credentials/token.json 中所述修改相应参数的值。

使用工具

获取空间列表

list_spaces

发送消息

create_message
  spaceName: "spaces/AAAA"
  text: "こんにちは！"

获取消息列表

list_messages
  spaceName: "spaces/AAAA"
  pageSize: 10

制限事项

  • 无法获取直接消息（DM） -根据Google Chat API的规格，人类之间的DM不能通过API取得
  • 因为使用了OAuth2认证，所以只能操作个人谷歌账户可以访问的空间
  • 注意Chat API的配额限制
  • 标记过期时自动刷新

许可证

麻省理工学院

相关 MCP