AI导哈

Google Chat MCP服务

一个用于Google Chat的模型上下文协议（MCP）服务器，使AI助手能够与Google Chat空间、消息和成员进行交互。

  • by nguyenvanduocit
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 nguyenvanduocit/google-chat-mcp

使用说明

谷歌聊天MCP

用于Google聊天的模型上下文协议（MCP）服务器，使AI助手能够与Google聊天空间、消息和成员进行交互。

特性

  • 空间：列出并获取Google聊天空间的详细信息
  • 消息：列出、获取、发送和删除邮件
  • 成员：列出并获取空间成员
  • 附件：将文件附件上载到邮件

先决条件

  1. 启用了Google Chat API的Google Cloud项目
  2. OAuth 2.0客户端ID凭据（桌面应用程序类型）

设置

1.创建OAuth 2.0凭据

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用 谷歌聊天API
  4. 首选 API和服务 > 凭证
  5. 点击 创建凭证 > OAuth客户端ID
  6. 选择 桌面应用 作为应用程序类型
  7. 下载JSON文件并将其另存为 google-credentials.json

2.生成OAuth令牌

使用附带的令牌生成工具：

# Build the token generator
go build -o get-google-token ./scripts/get-google-token

# Run it with your credentials file
./get-google-token \
  -credentials /path/to/google-credentials.json \
  -token /path/to/google-token.json

这将：

  1. 打开浏览器进行谷歌身份验证
  2. 要求您授权所需的Chat API作用域
  3. 将OAuth令牌保存到指定路径

3.设置环境变量

export GOOGLE_CREDENTIALS_FILE=/path/to/google-credentials.json
export GOOGLE_TOKEN_FILE=/path/to/google-token.json

或者创建一个 .env 文件：

GOOGLE_CREDENTIALS_FILE=/path/to/google-credentials.json
GOOGLE_TOKEN_FILE=/path/to/google-token.json

用法

安装

go install github.com/nguyenvanduocit/google-chat-mcp@latest

从源代码构建

go build -o google-chat-mcp .

运行（STDIO模式）

./google-chat-mcp --env .env

运行（HTTP模式）

./google-chat-mcp --env .env --http_port 3003

MCP配置

添加到MCP设置中：

STDIO模式

{
  "mcpServers": {
    "google-chat": {
      "command": "/path/to/google-chat-mcp",
      "args": ["--env", "/path/to/.env"]
    }
  }
}

HTTP模式

{
  "mcpServers": {
    "google-chat": {
      "url": "http://localhost:3003/mcp"
    }
  }
}

可用工具

空间

  • google_chat_list_spaces -列出所有可访问的谷歌聊天空间
  • google_chat_get_space -获取特定空间的详细信息

消息

  • google_chat_list_messages -在空间中列出邮件
  • google_chat_get_message -获取特定消息
  • google_chat_send_message -向空间发送消息
  • google_chat_delete_message -删除消息
  • google_chat_upload_attachment -将文件附件上载到空间

成员

  • google_chat_list_members -列出空间成员
  • google_chat_get_member -获取特定成员的详细信息

CLI使用情况

除了MCP服务器之外， google-chat-mcp 提供独立的CLI二进制文件(google-chat-cli)用于直接终端使用——不需要MCP客户端。

安装

just install-cli
# or
go install github.com/nguyenvanduocit/google-chat-mcp/cmd/google-chat-cli@latest

快速开始

export GOOGLE_CREDENTIALS_FILE=/path/to/credentials.json
export GOOGLE_TOKEN_FILE=/path/to/token.json
# or
google-chat-cli --env .env <command> [flags]

命令

命令 描述
list-spaces 列出谷歌聊天空间
get-space 获取空间详细信息
list-messages 在空间中列出邮件
get-message 获取特定消息
send-message 向空间发送消息
delete-message 删除消息
list-members 列出空间成员
get-member 获取会员详细信息

示例

# List spaces
google-chat-cli list-spaces

# Send a message
google-chat-cli send-message --space spaces/XXXXXX --text "Hello from CLI!"

# List messages
google-chat-cli list-messages --space spaces/XXXXXX

# JSON output
google-chat-cli list-spaces --output json | jq '.[].name'

旗帜

每个命令都接受：

  • --env string --通往 .env 文件
  • --output string --输出格式： text （默认）或 json

许可证

麻省理工学院

安装

自制（macOS/Linux）

brew install nguyenvanduocit/tap/google-chat-mcp

修复：触发PR创建后的发布处理权限修复

相关 MCP