MCP Google Workspace Server

MCP Google Workspace Server

site icon
2025.03.28 1
PythonGoogle Workspace 集成文档管理电子表格管理交流协作开发效率
MCP Google Workspace Server 是一个基于 Model Context Protocol (MCP) 的服务,旨在使 AI 代理能够与 Google Workspace(包括 Drive、Docs 和 Sheets)服务进行交互。该服务提供了丰富的功能,包括文件搜索、文件夹创建、文档和电子表格的创建、读取和更新等。支持多种传输模式,如 stdio、SSE 和 WebSocket,并且兼容 MCP 客户端(如 Cursor)。
View on GitHub

Overview

🌟 核心功能

  • Google Drive: 搜索文件、创建文件夹
  • Google Docs: 创建、读取、更新文档
  • Google Sheets: 创建电子表格、读取/写入单元格值
  • 多种传输模式: stdio(默认)、SSE、WebSocket
  • MCP 兼容客户端支持: 如 Cursor 等

📋 适用场景

  • AI 代理与 Google Workspace 服务的交互
  • 自动化文档和电子表格管理
  • 团队协作中的文件共享和管理

🛠️ 工具列表

Drive 操作

  • drive_search_files: 在 Google Drive 中搜索文件
  • drive_create_folder: 创建新文件夹

Docs 操作

  • docs_create: 创建新文档
  • docs_get_content: 获取文档内容
  • docs_update_content: 更新文档内容

Sheets 操作

  • sheets_create: 创建新电子表格
  • sheets_get_values: 获取单元格值
  • sheets_update_values: 更新单元格值

🔧 常见问题解答

  1. 如何配置 Google OAuth?
  2. 访问 Google Cloud Console,启用 Drive、Docs 和 Sheets API,创建 OAuth 2.0 凭据并保存为 ~/.google/oauth.keys.json,然后运行 mcp-google auth 进行认证。

  3. 如何调试?

  4. 使用 MCP Inspector 进行交互式测试。

📋 使用教程

使用依赖

确保已安装 Python 和 pip。

安装教程

使用 uv(推荐)

uvx mcp-google-suite

使用 pip

pip install mcp-google-suite

开发设置

git clone [email protected]:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # 或在 Windows 上使用 .venv\Scripts\activate
uv pip install -e .

调试方式

使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uvx mcp-google

对于开发环境:

cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

许可证

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