Google Drive MCP Server

Google Drive MCP 服务

用于与 Google Drive API 交互的模型上下文协议（MCP）服务。此服务为 AI 系统提供标准化接口，以访问和操作 Google Drive 中的文件。

功能

• 文件操作：列出、上传、下载和删除文件
• 文件夹管理：创建文件夹并整理内容
• 文件共享：与指定用户共享文件并管理权限
• 分页支持：高效处理大量文件列表
• 全面的错误处理：提供详细的错误报告，便于调试

前提条件

• Python 3.8+
• 已启用 Drive API 的 Google Cloud 项目
• 具有相应权限的服务账号

设置

1. Google Cloud 设置

1. 在 Google Cloud Console 中创建项目
2. 启用 Google Drive API
3. 创建具有相应权限的服务账号
4. 下载服务账号 JSON 密钥文件

2. 本地设置

克隆仓库并安装依赖项：

# Clone the repository
git clone <repository-url>
cd mcp-server-gdrive

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Copy example environment file and edit with your settings
cp .env.example .env

使用配置编辑 .env 文件：

HOST=0.0.0.0
PORT=8055
GOOGLE_SERVICE_ACCOUNT_FILE=your-service-account-file.json

3. Docker 设置

或者，也可以使用 Docker：

# Build and run with Docker Compose
docker-compose up --build

运行服务

本地运行

python main.py --transport sse

Docker 运行

docker-compose up

MCP 工具

此服务提供以下 MCP 工具：

文件操作

• list_files：列出 Google Drive 中的文件，支持分页
• get_file_info：获取特定文件的详细信息
• upload_file：将文件上传到 Google Drive
• download_file：从 Google Drive 下载文件

文件夹操作

• create_folder：在 Google Drive 中创建新文件夹

共享和权限

• share_file：与其他用户共享文件或文件夹

调试

• debug_api_connection：调试 Google Drive API 连接

客户端配置

要从客户端连接到此 MCP 服务：

{
  "gdrive": {
    "transport": "sse",
    "serverUrl": "http://localhost:8055/sse"
  }
}

注意：使用 SSE 传输时，请确保在 URL 末尾添加 /sse。

安全注意事项

• 服务账号 JSON 文件包含敏感凭据。切勿将其提交到版本控制系统。
• 使用环境变量保存所有敏感配置。
• 如果公开部署，请考虑实施额外的身份验证。

许可证

MIT 许可证

贡献

欢迎贡献！欢迎提交 Pull Request。