MCP Google Workspace 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 代理能够与 Google Workspace (云端硬盘、文档和表格) 服务进行交互。

🌟 功能

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

📋 安装

使用 uv (推荐)

uvx mcp-google-suite

使用 pip

pip install mcp-google-suite

开发环境设置

# 克隆并安装
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 设置

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

可用工具

云端硬盘操作

• drive_search_files: 在 Google 云端硬盘中搜索文件
  • 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 (数组, 必需): 值的二维数组

🛠️ 开发

# 安装开发依赖
uv pip install -e ".[dev]"

# 设置 pre-commit 钩子
pre-commit install

# 运行测试
pytest

# 格式化代码
black . && ruff check --fix .

🔍 调试

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

# 使用 uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# 用于开发
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 资源

• 文档
• MCP Inspector
• Pre-commit Hooks
• Google Cloud Console

🤝 贡献

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

🔒 安全

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

📄 许可证

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