AI导哈

Google Workspace服务器协议

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

  • by adexltd
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 adexltd/mcp-google-suite

使用说明

MCP谷歌工作空间服务器

模型上下文协议（MCP）服务器，使AI代理能够与Google Workspace（驱动器、文档和表格）服务进行交互。

🌟 特性

  • 谷歌云端硬盘：搜索文件，创建文件夹
  • 谷歌文档：创建、阅读、更新文档
  • 谷歌表格：创建电子表格，读/写单元格值
  • 多种传输模式：stdio（默认）、SSE、WebSocket
  • MCP兼容客户端支持（游标等）

📋 安装

使用紫外线（推荐）

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. 访问 谷歌云控制台
  2. 启用驱动器、文档和表格API
  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 （array，必填）：二维值数组

🛠️ 发展

# 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检查器进行交互式测试：

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

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

📚 资源

🤝 贡献

请阅读 贡献.md 有关我们的行为准则和提交pull请求流程的详细信息。

🔒 安全

看 安全.md 用于报告漏洞和最佳实践。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

相关 MCP