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设置
- 访问 谷歌云控制台
- 启用驱动器、文档和表格API
- 创建OAuth 2.0凭据
- 另存为
~/.google/oauth.keys.json - 跑
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许可证-请参阅 许可证 文件以获取详细信息。