Google Chat MCP Server

🚀 MCP（模型控制協議）服務器Google Chat集成項目

此項目為MCP（模型控制協議）服務器增添了Google Chat集成功能，藉助Python和FastMCP開發。它能讓您通過MCP工具與Google Chat裡的空間和消息進行交互，實現對自身Google Chat數據（如空間和消息）的查看與管理。

🚀 快速開始

準備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雲控制檯 (https://console.cloud.google.com/auth/overview?project=<YOUR_PROJECT_NAME>)。
4. 在“身份驗證平臺 > 客戶端 > (+) 創建客戶端”中創建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。

運行認證服務器並獲取Google訪問令牌

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

• 打開瀏覽器訪問 http://localhost:8000/auth。
• 使用Google賬號登錄。
• 登錄完成後，您的訪問令牌將保存為token.json。

MCP配置（mcp.json）

在項目根目錄下創建或修改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"
            ]
        }
    }
}

✨ 主要特性

• 支持OAuth 2.0與Google Chat API的身份驗證。
• 可列出可訪問的Google Chat空間。
• 能從特定空間中按日期篩選獲取消息。
• 擁有獨立認證服務器，方便部署。

📦 安裝指南

• 確保安裝Python 3.8+。
• 擁有啟用Chat API的Google Cloud項目。
• 準備好Google Cloud控制檯中的OAuth2憑證。

💻 使用示例

基礎用法

# 列出所有可訪問的Google Chat空間
from server import get_chat_spaces
spaces = get_chat_spaces()
print(spaces)

高級用法

# 從特定Google Chat空間中獲取消息，支持按時間範圍篩選
from server import get_space_messages
start_date = "2024-01-01"
end_date = "2024-01-31"
space_name = "your_space_name"
messages = get_space_messages(space_name, start_date, end_date)
print(messages)

📚 詳細文檔

項目結構

該項目包含兩個主要組件：

1. 帶Google Chat工具的MCP服務器：提供與Google Chat交互的工具。
   • 使用FastMCP編寫。
   • server.py：MCP主服務實現，集成Google Chat工具。
   • google_chat.py：Google Chat API集成和身份驗證處理。
2. 認證服務器：獨立組件，用於Google賬號身份驗證。
   • 使用FastAPI編寫。
   • 處理OAuth2與Google的交互流程。
   • 存儲和管理訪問令牌。
   • 可以單獨運行或作為MCP服務的一部分運行。
   • server_auth.py：認證服務器實現。

通過身份驗證流程，您可以獲取並刷新Google API令牌，這些令牌會被MCP工具用於訪問Google Chat數據（您的空間和消息）。

提供的工具

MCP服務器提供以下工具：

• get_chat_spaces()：列出所有可訪問的Google Chat空間。
• get_space_messages(space_name: str, start_date: str, end_date: str = None)：從特定Google Chat空間中獲取消息，支持按時間範圍篩選。

🔧 技術細節

本項目使用Python和FastMCP編寫，通過OAuth 2.0協議與Google Chat API進行身份驗證。認證服務器使用FastAPI實現，負責處理OAuth2與Google的交互流程，存儲和管理訪問令牌。MCP服務器集成了Google Chat工具，可通過獲取的令牌訪問Google Chat數據。

💻 開發與調試

fastmcp dev server.py --with-editable .