谷歌云端硬盘服务器
此MCP服务器与Google Drive集成，允许列出、读取和搜索文件，以及读取和写入Google表格。
该项目包括最初由Anthropic，PBC开发的代码，根据MIT许可证从 此回购.
组件
工具
- gdrive_search
- 描述：在Google Drive中搜索文件。 - 输入: - query （string）：搜索查询。 - pageToken （字符串，可选）：下一页结果的标记。 - pageSize （数字，可选）：每页结果数（最多100个）。 - 输出：返回匹配文件的文件名和MIME类型。
- gdrive_read_file
- 描述：从Google云端硬盘读取文件内容。 - 输入: - fileId （string）：要读取的文件的ID。 - 输出：返回指定文件的内容。
- gsheets_read
- 描述：从谷歌电子表格中读取数据，范围和格式选项灵活。 - 输入: - spreadsheetId （string）：要读取的电子表格的ID。 - ranges （字符串数组，可选）：A1表示法范围的可选数组（例如。， ['Sheet1!A1:B10']).如果没有提供，请读取整张表。 - sheetId （数字，可选）：要读取的特定纸张ID。如果没有提供范围，则读取第一页。 - 输出：从电子表格中返回指定的数据。
- gsheets_update_cell
- 描述：更新Google电子表格中的单元格值。 - 输入: - fileId （string）：电子表格的ID。 - range （string）：A1表示法中的单元格范围（例如。， 'Sheet1!A1'). - value （string）：新单元格值。 - 输出：确认指定单元格中的更新值。
资源
服务器提供对Google Drive文件的访问：
- 文件 (
gdrive:///)
- 支持所有文件类型 - Google Workspace文件会自动导出： - Docs → 降价 - 表格→ CSV - 演示→ 纯文本 - 图纸→ PNG - 其他文件以其原生格式提供
入门
- 创建新的Google Cloud项目
- 启用Google Drive API
- 配置OAuth同意屏幕 （“内部”适合测试）
- 添加OAuth作用域
https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/spreadsheets - 为了允许与工作表和文档进行交互，您还需要启用 谷歌网页API 和 谷歌文档API 在您的工作区启用API和服务部分。
- 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序”
- 下载客户端OAuth密钥的JSON文件
- 将密钥文件重命名为
gcp-oauth.keys.json并放置到您指定的路径中GDRIVE_CREDS_DIR（即。/Users/username/.config/mcp-gdrive) - 记下您的OAuth客户端ID和客户端密码。它们必须作为环境变量与配置目录一起提供。
- 您还需要在项目中设置一个.env文件，其中包含以下字段。您可以在Google Cloud控制台的凭据部分找到客户端ID和客户端密码。
GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=
CLIENT_SECRET=确保使用以下任一方法构建服务器 npm run build 或 npm run watch.
认证
接下来，你需要跑步 node ./dist/index.js 触发身份验证步骤
系统将提示您使用浏览器进行身份验证。您必须使用与您的Google Cloud项目所在组织相同的帐户进行身份验证。
您的OAuth令牌保存在由 GDRIVE_CREDS_DIR 环境变量。
使用桌面应用程序
要将此服务器与桌面应用程序集成，请将以下内容添加到应用程序的服务器配置中：
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@isaacphi/mcp-gdrive"],
"env": {
"CLIENT_ID": "",
"CLIENT_SECRET": "",
"GDRIVE_CREDS_DIR": "/path/to/config/directory"
}
}
}
}许可证
此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。