Google Drive MCP服务器

一个用于与Google Drive文档交互的MCP服务器,支持OAuth认证和Docker部署。

  • by julian-hecker
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 julian-hecker/drive-mcp

使用说明

谷歌云端硬盘MCP

我创建这个项目是为了学习如何使用OAuth构建MCP服务器。

您可以使用此MCP服务器与您的Google Drive文档进行交互。

设置

需求

要设置此项目,您需要 uv 它是Python的包和项目管理器。

你还需要Python 3.13,你可以使用 uv python install 3.13.

安装和配置后 uv,跑 uv sync 在这个项目的根。这将创建一个虚拟环境并安装依赖关系。

环境

您需要一个Google OAuth客户端ID和客户端密码。

您可以在GCP控制台中创建这些,位于 API和服务>凭据.

创建后,将其设置为 .env 像这样的:

GOOGLE_CLIENT_ID=0123456789-abcdefghijklmnopqrstuvwxyz.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOOGLE_AUTH_CLIENT_SECRET

您还需要在GCP中启用Google Drive API。

用法

在VSCode中,只需转到 Run and Debug 选项卡并启动 FastMCP: Drive MCP.

或者,你可以跑步

uvicorn drive_mcp.main:app --host 0.0.0.0 --port 8080 --reload

或

poe mcp-run

无论哪种方式都会在以下位置启动服务器 http://localhost:8080.

在您的MCP客户端中,添加 http://localhost:8080/mcp 作为服务器URL。对于游标,如下所示:

{
  "mcpServers": {
    "drive-mcp": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

激活后,光标将要求您在浏览器中进行身份验证。

这将把您发送到FastMCP的web UI,然后将您重定向到谷歌登录。

码头工人

如果你使用Docker,你可以构建、运行和部署这个项目。

首先,确保Docker正在运行。然后,

要构建:

docker build -t drive-mcp -f apps/drive-mcp/Dockerfile .

或

poe mcp-build

要在本地运行:

docker run -p 8080:8080 --env-file .env drive-mcp

部署

一旦你构建了Docker镜像,你就可以在GCP cloud Run等云服务上托管它。

托管时,您还需要更改 BASE_URL 环境变量以反映部署URL。