Google Drive MCP 服务器

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

功能

• 在 Google Drive 中搜索文件
• 获取文件内容和元数据
• 使用带有令牌持久化的 OAuth 认证
• 支持 HTTP 和 stdio 传输模式

要求

• Python 3.12 或更高版本
• Google Drive API 凭据

配置

1. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

2. 安装包到可编辑模式：

pip install -e .

3. 设置 Google Drive API 凭据：

   • 前往 Google Cloud 控制台
   • 创建一个新项目或选择现有项目
   • 为您的项目启用 Google Drive API
   • 在左侧边栏中点击“凭据”
   • 点击“创建凭据”并选择“OAuth 客户端 ID”
   • 选择“桌面应用”作为应用程序类型
   • 下载凭据文件并将其保存为 credentials.json

4. 设置 Google Drive 认证：

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

使用方法

运行服务器：

# 标准模式
gdrive-mcp

# HTTP 模式
gdrive-mcp --http

Claude Desktop 集成

要与 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 服务器框架
• FastMCP 用于 HTTP 传输
• Rich 用于终端格式化

开发依赖项可以安装如下：

pip install -e ".[dev]"

许可证

MIT 许可证