FG

felores/gdrive-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

72 stars 40 forks 质量 69 趋势 14MIT

felores/gdrive-mcp-server 是从 https://github.com/felores/gdrive-mcp-server. 导入的 MCP 服务器候选

概览

felores/gdrive-mcp-server 是从 https://github.com/felores/gdrive-mcp-server. 导入的 MCP 服务器候选

概述(AI 翻译)

一个强大的模型上下文协议(MCP)服务器,实现与 Google Drive 的无缝集成,使 AI 模型能够搜索、列出并读取 Google Drive 文件。

🚀 特色

工具

1.gdrive_search

在你的Google Drive中,通过强大的全文搜索功能搜索文件。

  • 输入:

  • 输出:包含以下文件列表:

  • 文件名

  • 哑剧类型

  • 文件ID

  • 最近修改时间

  • 文件大小

2.gdrive_read_file

直接通过Google Drive文件ID读取文件内容。

  • 输入:

  • 输出:文件内容并进行适当格式转换

自动文件格式处理

服务器智能地处理不同的 Google Workspace 文件类型:

  • 📝 Google 文档→ Markdown
  • 📊 Google Sheets → CSV
  • 📊 谷歌简报→纯文本
  • 🎨 谷歌绘图→PNG
  • 📄 文本/JSON 文件→ UTF-8 文本
  • 📦 其他→ Base64 编码的文件

🛠️ 开始

先决条件

  • Node.js(v16或更高)
  • NPM或纱线
  • 谷歌云项目
  • Google Workspace 或个人 Google 账户

谷歌云详细设置

  1. 创建谷歌云项目
  • 访问谷歌云控制台
  • 点击“新项目”

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Google Drive MCP Server

A powerful Model Context Protocol (MCP) server that provides seamless integration with Google Drive, allowing AI models to search, list, and read files from Google Drive.

🚀 Features

Tools

1. gdrive_search

Search for files in your Google Drive with powerful full-text search capabilities.

  • Input:
    {
      "query": "string (your search query)"
    }
    
  • Output: List of files with:
    • File name
    • MIME type
    • File ID
    • Last modified time
    • File size

2. gdrive_read_file

Read file contents directly using a Google Drive file ID.

  • Input:
    {
      "file_id": "string (Google Drive file ID)"
    }
    
  • Output: File contents with appropriate format conversion

Automatic File Format Handling

The server intelligently handles different Google Workspace file types:

  • 📝 Google Docs → Markdown
  • 📊 Google Sheets → CSV
  • 📊 Google Presentations → Plain text
  • 🎨 Google Drawings → PNG
  • 📄 Text/JSON files → UTF-8 text
  • 📦 Other files → Base64 encoded

🛠️ Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • A Google Cloud Project
  • A Google Workspace or personal Google account

Detailed Google Cloud Setup

  1. Create a Google Cloud Project

    • Visit the Google Cloud Console
    • Click “New Project”
    • Enter a project name (e.g., “MCP GDrive Server”)
    • Click “Create”
    • Wait for the project to be created and select it
  2. Enable the Google Drive API

    • Go to the API Library
    • Search for “Google Drive API”
    • Click on “Google Drive API”
    • Click “Enable”
    • Wait for the API to be enabled
  3. Configure OAuth Consent Screen

    • Navigate to OAuth consent screen
    • Select User Type:
      • “Internal” if you’re using Google Workspace
      • “External” for personal Google accounts
    • Click “Create”
    • Fill in the required fields:
      • App name: “MCP GDrive Server”
      • User support email: your email
      • Developer contact email: your email
    • Click “Save and Continue”
    • On the “Scopes” page:
      • Click “Add or Remove Scopes”
      • Add https://www.googleapis.com/auth/drive.readonly
      • Click “Update”
    • Click “Save and Continue”
    • Review the summary and click “Back to Dashboard”
  4. Create OAuth Client ID

    • Go to Credentials
    • Click “Create Credentials” at the top
    • Select “OAuth client ID”
    • Choose Application type: “Desktop app”
    • Name: “MCP GDrive Server Desktop Client”
    • Click “Create”
    • In the popup:
      • Click “Download JSON”
      • Save the file
      • Click “OK”
  5. Set Up Credentials in Project

    # Create credentials directory
    mkdir credentials
    
    # Move and rename the downloaded JSON file
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "gdrive": { "command": "node", "args": ["path/to/gdrive-mcp-server/dist/index.js"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/gcp-oauth.keys.json", "MCP_GDRIVE_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/.gdrive-server-credentials.json" } } } }