MCP 服务器

mcp-google-docs

使用 MCP (Metoro 控制协议) 操作 Google 表格和 Google 云端硬盘的工具。

README

MCP Google Spreadsheet

用于操作 Google Spreadsheet 和 Google Drive 的 MCP (Metoro Control Protocol) 工具。 A tool for manipulating Google Spreadsheet and Google Drive using MCP (Metoro Control Protocol).

功能 (Features)

Google Drive 功能 (Google Drive Features)

文件列表查询 (List files)
文件复制 (Copy files)
文件重命名 (Rename files)
创建空白电子表格 (Create empty spreadsheets)
基于模板创建电子表格 (Create spreadsheets from templates)
复制现有电子表格 (Copy existing spreadsheets)

Google Sheets 功能 (Google Sheets Features)

工作表列表查询 (List sheets)
工作表复制 (Copy sheets)
工作表重命名 (Rename sheets)
工作表数据查询 (Get sheet data)
添加/删除行 (Add/Delete rows)
添加/删除列 (Add/Delete columns)
单元格更新 (Update cells)
创建/修改/删除图表 (Create/Update/Delete charts)
单元格格式更改 (Update cell formats)

安装方法 (Installation)

1. 虚拟环境设置 (Virtual Environment Setup)

macOS/Linux

# 创建虚拟环境 (Create virtual environment)
python -m venv venv

# 激活虚拟环境 (Activate virtual environment)
source venv/bin/activate

Windows

# 创建虚拟环境 (Create virtual environment)
python -m venv venv

# 激活虚拟环境 (Activate virtual environment)
venv\Scripts\activate

2. 安装所需软件包 (Install Required Packages):

pip install -r requirements.txt

3. Google Cloud Console 设置 (Google Cloud Console Setup)

在 Google Cloud Console 中创建一个项目。(Create a project in Google Cloud Console)
创建 OAuth 2.0 客户端 ID。(Create OAuth 2.0 client ID)
启用所需的 API：(Enable required APIs:)
- Google Sheets API
- Google Drive API

4. 环境变量设置 (Environment Variables Setup):

export MCPGD_CLIENT_SECRET_PATH="/path/to/client_secret.json"
export MCPGD_FOLDER_ID="your_folder_id"
export MCPGD_TOKEN_PATH="/path/to/token.json"  # 可选项 (Optional)

使用方法 (Usage)

1. 运行程序 (Run the Program):

python main.py

2. 通过 MCP 使用工具 (Use Tools via MCP):

# 示例：文件列表查询 (Example: List files)
mcp list_files

# 示例：工作表数据查询 (Example: Get sheet data)
mcp get_sheet_data --spreadsheet-id "your_spreadsheet_id" --range "Sheet1!A1:D10"

# 示例：创建图表 (Example: Create chart)
mcp create_chart --chart-type "LINE" --range "A1:B10" --sheet-name "Sheet1" --title "Sales Trend"

环境变量 (Environment Variables)

MCPGD_CLIENT_SECRET_PATH: Google OAuth 2.0 客户端密钥文件路径 (Path to Google OAuth 2.0 client secret file)
MCPGD_FOLDER_ID: Google Drive 文件夹 ID (Google Drive folder ID)
MCPGD_TOKEN_PATH: 令牌存储文件路径 (Path to token storage file, Optional, Default: ~/.mcp_google_spreadsheet.json)