使用说明

项目简介

Google Drive MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 客户端提供访问 Google Drive 中文件和文件夹的能力。通过此服务器，LLM 客户端可以搜索 Google Drive 中的文件，并获取文件的内容和元数据，从而扩展 LLM 的上下文信息来源和功能。

主要功能点

文件搜索: 允许 LLM 客户端通过关键词在 Google Drive 中搜索文件。
文件内容获取: 允许 LLM 客户端获取指定 Google Drive 文件的内容和元数据。
OAuth 认证: 使用 OAuth 2.0 协议进行身份验证，安全访问 Google Drive 数据。
多种传输模式: 支持标准输入输出 (stdio) 和 HTTP 两种传输模式，方便集成到不同的 LLM 客户端环境中。

安装步骤

安装 Python 3.12+: 确保您的系统已安装 Python 3.12 或更高版本。

创建虚拟环境:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows

安装项目:
```
pip install -e .
```
配置 Google Drive API 凭据:
- 访问 Google Cloud Console。
- 创建或选择一个项目。
- 为您的项目启用 Google Drive API。
- 在左侧边栏选择 "凭据"。
- 点击 "创建凭据"，选择 "OAuth 客户端 ID"。
- 应用类型选择 "桌面应用"。
- 下载凭据 JSON 文件，并将其保存为 'credentials.json'。

进行 Google Drive 身份验证:

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

请将 '/path/to/your/credentials.json' 替换为您下载的 'credentials.json' 文件的实际路径，'/path/to/your/tokens.json' 替换为您希望保存 token 文件的路径。此步骤将引导您完成 OAuth 授权流程，并将授权 token 保存到指定路径。

服务器配置

以下是将 Google Drive MCP Server 集成到 MCP 客户端（例如 Claude Desktop）的配置示例。您需要在客户端的配置文件中添加类似以下的 JSON 配置：

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

配置参数说明:

'server name': 'google_drive' (服务器名称，客户端用以标识和调用)
'command': '/path/to/your/venv/bin/gdrive-mcp' (指向 'gdrive-mcp' 启动脚本的绝对路径，请根据您的虚拟环境路径进行调整)
'args': 启动参数列表
- '--token': '/path/to/your/tokens.json' (指向 token 文件的路径，此文件在身份验证步骤生成)

基本使用方法

启动服务器：

标准模式 (stdio):

gdrive-mcp --token /path/to/your/tokens.json

HTTP 模式:

gdrive-mcp --http --token /path/to/your/tokens.json

请确保将 '/path/to/your/tokens.json' 替换为您在身份验证步骤中指定的 token 文件路径。服务器启动后，MCP 客户端可以通过配置的服务器名称 ('google_drive') 和工具名称 ('search_files', 'get_file') 调用 Google Drive 的相关功能。

关键词