简介

本项目为使用 Python 和 FastMCP 编写的 MCP (模型控制协议) 服务器提供 Google Chat 集成。它允许您通过 MCP 工具访问和交互 Google Chat 空间和消息。

结构

该项目由两个主要组件组成：

1. 带有 Google Chat 工具的 MCP 服务器: 提供通过模型控制协议与 Google Chat 交互的工具。

   • 由 FastMCP 编写
   • server.py: 带有 Google Chat 工具的主要 MCP 服务器实现
   • google_chat.py: Google Chat API 集成和身份验证处理

2. 身份验证服务器: 用于 Google 帐户身份验证的独立组件

   • 由 FastAPI 编写
   • 处理与 Google 的 OAuth2 流程
   • 存储和管理访问令牌
   • 可以独立运行或作为 MCP 服务器的一部分运行
   • server_auth.py: 身份验证服务器实现

身份验证流程允许您获取和刷新 Google API 令牌，然后 MCP 工具使用这些令牌来访问 Google Chat 数据。（您的空间和消息）

功能

• 与 Google Chat API 的 OAuth2 身份验证
• 列出可用的 Google Chat 空间
• 从特定空间检索消息，并具有日期过滤功能
• 用于轻松设置的本地身份验证服务器

要求

• Python 3.8+
• 启用了 Chat API 的 Google Cloud 项目
• 来自 Google Cloud Console 的 OAuth2 凭据

如何使用？

准备 Google Oauth 登录

1. 克隆此项目

   git clone https://github.com/chy168/google-chat-mcp-server.git
   cd google-chat-mcp-server
   

2. 准备一个 Google Cloud 项目 (GCP)
3. Google Cloud 控制台 (https://console.cloud.google.com/auth/overview?project=<YOUR_PROJECT_NAME>)
4. Google Auth Platform > Clients > (+) 创建客户端 > Web 应用程序 参考: https://developers.google.com/identity/protocols/oauth2/?hl=en 授权的 JavaScript 来源添加: http://localhost:8000 授权的重定向 URI: http://localhost:8000/auth/callback
5. 创建 OAuth 2.0 客户端后，将客户端密钥下载为 .json 文件。 将其另存为项目顶层的 credentials.json。

运行 Auth 服务器并获取您的 Google 访问令牌（仅登录 Google，尚未登录 MCP 服务器）

python server.py -local-auth --port 8000

• 在浏览器中打开 http://localhost:8000/auth
• 登录！
• 登录后，您的访问令牌将保存为 token.json

MCP 配置 (mcp.json)

{
    "mcpServers": {
        "google_chat": {
            "command": "uv",
            "args": [
                "--directory",
                "<YOUR_REPO_PATH>/google-chat-mcp-server",
                "run",
                "server.py",
                "--token-path",
                "<YOUR_REPO_PATH>/google-chat-mcp-server/token.json"
            ]
        }
    }
}

工具

MCP 服务器提供以下工具：

Google Chat 工具

• get_chat_spaces() - 列出机器人可以访问的所有 Google Chat 空间
• get_space_messages(space_name: str, start_date: str, end_date: str = None) - 列出特定 Google Chat 空间中的消息，并具有可选的时间过滤

开发和调试

fastmcp dev server.py --with-editable .