Google Drive server

基本能力

产品定位

mcp-gdrive 是一个与 Google Drive 集成的 MCP 服务器，主要用于文件管理和搜索。

核心功能

• 文件搜索：通过 search 工具搜索 Google Drive 中的文件，返回文件名和 MIME 类型。
• 文件访问：支持所有文件类型，并能自动转换 Google Workspace 文件为通用格式。
• 资源访问：通过 gdrive:///<file_id> 访问 Google Drive 文件。

适用场景

• 需要从 Google Drive 中搜索和访问文件的场景。
• 需要将 Google Workspace 文件转换为通用格式的场景。

工具列表

• search：搜索 Google Drive 中的文件，输入为搜索查询字符串，返回匹配文件的文件名和 MIME 类型。

常见问题解答

• 如何认证？：运行 node ./dist auth 命令，完成浏览器中的认证流程。
• 如何保存认证信息？：认证完成后，凭证会保存在 servers/.gdrive-server-credentials.json 文件中。

使用教程

使用依赖

1. 创建一个新的 Google Cloud 项目。
2. 启用 Google Drive API。
3. 配置 OAuth 同意屏幕（测试时可选择 "internal"）。
4. 添加 OAuth 范围 https://www.googleapis.com/auth/drive.readonly。
5. 为 "Desktop App" 类型的应用创建 OAuth Client ID。
6. 下载 OAuth 密钥的 JSON 文件，并重命名为 gcp-oauth.keys.json，放置在项目根目录下。

安装教程

1. 使用 npm run build 或 npm run watch 构建服务器。
2. 运行 node ./dist auth 进行认证。

调试方式

• Docker： bash docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth
• NPX： json { "mcpServers": { "gdrive": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-gdrive" ] } } }

许可证

该项目遵循 MIT 开源许可条款。