
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 账户
谷歌云详细设置
- 创建谷歌云项目
- 访问谷歌云控制台
- 点击“新项目”
本页由 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
-
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
-
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
-
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”
-
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”
-
Set Up Credentials in Project
# Create credentials directory mkdir credentials # Move and rename the downloaded JSON file
安装
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"
}
}
}
}