Google Drive MCP 服务器

一个提供MCP(机器控制协议)接口以与Google Drive文件和文件夹交互的服务器。

  • by hxie-pallas
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 hxie-pallas/gdrive-mcp-server

使用说明

Google Drive MCP服务器

提供MCP(机器控制协议)接口以与Google Drive文件和文件夹交互的服务器。

特性

  • 在Google云端硬盘中搜索文件
  • 获取文件内容和元数据
  • 具有令牌持久性的OAuth身份验证
  • HTTP和stdio传输模式

需求

  • Python 3.12或更高版本
  • Google Drive API证书

设置

  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 在可编辑模式下安装软件包:
pip install -e .
  1. 设置Google Drive API凭据:

    • 转到 谷歌云控制台
    • 创建新项目或选择现有项目
    • 为您的项目启用Google Drive API
    • 转到左侧边栏中的“凭据”
    • 点击“创建凭据”并选择“OAuth客户端ID”
    • 选择“桌面应用程序”作为应用程序类型
    • 下载凭据文件并将其另存为 credentials.json
  2. 设置Google Drive身份验证:

python -m gdrive_mcp_server.auth_setup --credentials /path/to/your/credentials.json --token /path/to/your/tokens.json

用法

运行服务器:

# Standard mode
gdrive-mcp

# HTTP mode
gdrive-mcp --http

Claude桌面集成

要与Claude Desktop集成,请将以下配置添加到您的 claude_desktop_config.json:

"mcpServers": {
  "google_drive": {
    "command": "/path/to/your/venv/bin/gdrive-mcp",
    "args": [
      "--token",
      "/path/to/your/tokens.json"
    ]
  }
}

用实际路径替换路径:

  • command:虚拟环境中gdrive-mcp可执行文件的路径
  • args[1]:您的tokens.json文件的路径(在身份验证设置过程中生成)

发展

该项目使用:

  • Python 3.12+
  • Google Drive API
  • MCP服务器框架
  • 用于HTTP传输的FastMCP
  • 丰富的终端格式化功能

开发依赖项可以通过以下方式安装:

pip install -e ".[dev]"

许可证

MIT许可证