MCP Google Workspace 服务器

👁 CI
👁 代码验证
👁 PyPI 版本
👁 许可证：MIT
👁 代码样式：黑色

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

🌟 功能

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

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

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

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

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

Related MCP server: MCP Google Workspace Server

📋 安装

使用 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 设置

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

🛠️ 开发

# 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

📚 资源

• 文档

• MCP 检查器

• 预提交钩子

• Google 云端控制台

🤝 贡献

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

🔒 安全

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

📄 许可证

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

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• docs_createC
• docs_get_contentC
• docs_update_contentC
• drive_create_folderC
• drive_search_filesC
• sheets_createC
• sheets_get_valuesC
• sheets_update_valuesC