mcp-gdrive-server

🚀 Google Drive 服务器

此 MCP 服务器与 Google Drive 集成，可实现文件的列出、读取和搜索功能，为用户提供便捷的文件管理体验。

🚀 快速开始

项目初始化

1. 创建一个新的 Google Cloud 项目
2. 启用 Google Drive API
3. 配置 OAuth 同意屏幕（测试时“内部”即可）
4. 添加 OAuth 作用域 https://www.googleapis.com/auth/drive.readonly
5. 为应用类型“桌面应用”创建 OAuth 客户端 ID
6. 下载客户端的 OAuth 密钥文件 JSON 文件
7. 将密钥文件重命名为 gcp-oauth.keys.json，并将其放置在当前仓库根目录中（例如 servers/gcp-oauth.keys.json）

确保使用 npm run build 或 npm run watch 进行构建。

认证流程

要进行认证并保存凭证：

1. 使用 auth 参数运行服务器：node ./dist auth
2. 浏览器系统会话中打开身份验证流程
3. 完成身份验证过程
4. 凭证将保存在当前仓库根目录中（例如 servers/.gdrive-server-credentials.json）

与桌面应用集成

要在桌面应用中使用此服务器，将其添加到应用的服务器配置中：

Docker

身份验证：

假设您已完成 Google Cloud 上 OAuth 应用的设置，现在可以使用以下命令对服务器进行身份验证，将 /path/to/gcp-oauth.keys.json 替换为密钥文件的实际路径：

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

命令将输出要在浏览器中打开的 URL。在浏览器中完成身份验证流程。凭证将保存在 mcp-gdrive 卷中。

一旦身份验证成功，可以在应用的服务器配置中使用以下内容：

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "mcp-gdrive:/gdrive-server", "-e", "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json", "mcp/gdrive"]
    }
  }
}

npm

要使用 npm 运行服务器：

npm start

直接运行

可以直接运行 JavaScript 文件：

node dist/index.js

✨ 主要特性

工具

• search
  • 搜索 Google Drive 中的文件
  • 输入：query（字符串）：搜索查询
  • 返回匹配文件的名称和 MIME 类型

资源

服务器提供对 Google Drive 文件的访问：

• Files（gdrive:///<file_id>）
  • 支持所有文件类型
  • 自动导出 Google Workspace 文件：
    • 文档 → Markdown
    • 表格 → CSV
    • 演示文稿 → 纯文本
    • 绘图 → PNG
  • 其他文件以原生格式提供

📄 许可证

请参阅项目的许可文件以获取详细信息。

📞 联系方式

如有任何问题，请通过以下方式联系：

• 邮件：your.email@example.com
• GitHub 仓库：github.com/username/repo