MCP Google Workspace 服务器

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

🌟 功能

• Google Drive：搜索文件、创建文件夹

• Google Docs：创建、阅读、更新文档

• Google 表格：创建电子表格、读取/写入单元格值

• 多种传输模式：stdio（默认）、SSE、WebSocket

• MCP 兼容客户端支持（Cursor 等）

📋 安装

使用 uv（推荐）

使用 pip

开发设置

🔧 配置

为 MCP 客户端配置

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

使用 uvx（推荐）：

使用pip安装：

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_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 （数组，必需）：值的二维数组

🛠️ 开发

🔍 调试

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

📚 资源

• 文档

• MCP 检查器

• 预提交钩子

• Google 云端控制台

🤝 贡献

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

🔒 安全

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

📄 许可证

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