HelloWorld
登录
j

josedu90

app-automationcloud-platformsdeveloper-tools

338 查看 · 2026-07-07 更新

MCP Google Workspace 服务器

CI codecov PyPI version License: MIT Code style: black

一个模型上下文协议（MCP）服务器，使AI代理能够与Google Workspace（Drive、Docs和Sheets）服务进行交互。

🌟 特性

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

📋 安装

使用uv（推荐）

bash uvx mcp-google-suite

使用pip

bash pip install mcp-google-suite

开发环境设置

bash

克隆并安装

git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite uv venv && source .venv/bin/activate # 或在Windows上使用.venvScriptsactivate uv pip install -e .

🔧 配置

为MCP客户端配置

将以下内容添加到您的客户端设置中（例如Cursor, Claude）：

使用uvx（推荐）： json { "mcpServers": { "mcp-google-suite": { "command": "uvx", "args": ["mcp-google-suite"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/.google/server-creds.json", "GOOGLE_OAUTH_CREDENTIALS": "/.google/oauth.keys.json" } } } }

使用pip安装： json { "mcpServers": { "mcp-google-suite": { "command": "python", "args": ["-m", "mcp_google_suite"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/.google/server-creds.json", "GOOGLE_OAUTH_CREDENTIALS": "/.google/oauth.keys.json" } } } }

Google OAuth 设置

  1. 访问 Google Cloud Console
  2. 启用Drive、Docs和Sheets API
  3. 创建OAuth 2.0凭据
  4. 保存为 ~/.google/oauth.keys.json
  5. 运行 mcp-google auth 进行身份验证

可用工具

Drive 操作

  • drive_search_files：在Google Drive中搜索文件
    • query (字符串, 必需): 搜索查询
    • page_size (整数, 可选): 返回的结果数量
  • drive_create_folder：创建新文件夹
    • name (字符串, 必需): 文件夹名称
    • parent_id (字符串, 可选): 父文件夹ID

Docs 操作

  • docs_create：创建新文档
    • title (字符串, 必需): 文档标题
    • content (字符串, 可选): 初始内容
  • docs_get_content：获取文档内容
    • document_id (字符串, 必需): 文档ID
  • docs_update_content：更新文档内容
    • document_id (字符串, 必需): 文档ID
    • content (字符串, 必需): 新内容

Sheets 操作

  • sheets_create：创建新电子表格
    • title (字符串, 必需): 电子表格标题
    • sheets (数组, 可选): 工作表名称
  • sheets_get_values：获取单元格值
    • spreadsheet_id (字符串, 必需): 电子表格ID
    • range (字符串, 必需): A1表示法范围
  • sheets_update_values：更新单元格值
    • spreadsheet_id (字符串, 必需): 电子表格ID
    • range (字符串, 必需): A1表示法范围
    • values (二维数组, 必需): 值数组

🛠️ 开发

bash

安装开发依赖

uv pip install -e ".[dev]"

设置pre-commit钩子

pre-commit install

运行测试

pytest

格式化代码

black . && ruff check --fix .

🔍 调试

使用MCP Inspector进行交互式测试：

bash

使用uvx

npx @modelcontextprotocol/inspector uvx mcp-google

开发用途

cd path/to/mcp-google-suite npx @modelcontextprotocol/inspector uv run mcp-google## 📚 资源

🤝 贡献

请阅读 CONTRIBUTING.md 以了解我们的行为准则和提交拉取请求的流程。

🔒 安全

有关报告漏洞和最佳实践的信息，请参阅 SECURITY.md。

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

工具列表

  • drive_search_files: Search for files in Google Drive

  • drive_create_folder: Create a new folder in Google Drive

  • docs_create: Create a new Google Doc

  • docs_get_content: Get the contents of a Google Doc

  • docs_update_content: Update the content of a Google Doc

  • sheets_create: Create a new Google Sheet

  • sheets_get_values: Get values from a Google Sheet range

  • sheets_update_values: Update values in a Google Sheet range

服务配置

[{'mcpServers': {'mcp-google-suite': {'args': ['mcp-google-suite'], 'command': 'uvx', 'env': {'GOOGLE_APPLICATION_CREDENTIALS': '~/.google/server-creds.json', 'GOOGLE_OAUTH_CREDENTIALS': '~/.google/oauth.keys.json'}}}}, {'mcpServers': {'mcp-google-suite': {'args': ['-m', 'mcp_google_suite'], 'command': 'python', 'env': {'GOOGLE_APPLICATION_CREDENTIALS': '~/.google/server-creds.json', 'GOOGLE_OAUTH_CREDENTIALS': '~/.google/oauth.keys.json'}}}}]

来源