MCP Google Workspace 服务器

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

🌟 功能

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

📋 安装

使用 uv（推荐）

uvx mcp-google-suite

使用 pip

pip install mcp-google-suite

开发设置

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 配置

为 MCP 客户端配置

添加到您的客户端设置（例如 Cursor、Claude）：

使用 uvx（推荐）：

{
  "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安装：

{
  "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 设置

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

可用工具

驱动操作

drive_search_files ：在 Google Drive 中搜索文件
- query （字符串，必需）：搜索查询
- page_size （整数，可选）：要返回的结果数
drive_create_folder ：创建新文件夹
- name （字符串，必需）：文件夹名称
- parent_id （字符串，可选）：父文件夹 ID

文档操作

docs_create ：创建新文档
- title （字符串，必需）：文档标题
- content （字符串，可选）：初始内容
docs_get_content ：获取文档内容
- document_id （字符串，必需）：文档 ID
docs_update_content ：更新文档内容
- document_id （字符串，必需）：文档 ID
- content （字符串，必需）：新内容

工作表操作

sheets_create ：创建一个新的电子表格
- title （字符串，必需）：电子表格标题
- sheets （数组，可选）：工作表名称
sheets_get_values ：获取单元格值
- spreadsheet_id （字符串，必需）：电子表格 ID
- range （字符串，必需）：A1 符号范围
sheets_update_values ：更新单元格值
- spreadsheet_id （字符串，必需）：电子表格 ID
- range （字符串，必需）：A1 符号范围
- values （数组，必需）：值的二维数组

🛠️ 开发

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 调试

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

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

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

📚 资源

🤝 贡献

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

🔒 安全

请参阅SECURITY.md以了解报告漏洞和最佳实践。

📄 许可证

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

MCP Google Workspace Server

Integrations