Google Workspace MCP 服务器

用于与 Google Workspace API 交互的模型上下文协议 (MCP) 服务器，包括 Gmail、云端硬盘、日历、文档、表格和幻灯片。

## 功能

- **Gmail API**: 发送电子邮件、列出邮件、管理标签等
- **云端硬盘 API**: 列出文件、创建文件夹和上传文件
- **文档 API**: 创建和编辑 Google 文档
- **表格 API**: 读取和写入电子表格数据
- **幻灯片 API**: 创建演示文稿和幻灯片
- **日历 API**: 列出和创建日历事件
- **身份验证**: OAuth2 身份验证流程助手

## 前提条件

- Node.js 16+
- 启用了必要 API 的 Google Cloud 项目
- OAuth 2.0 客户端凭据

## 安装

```bash
npm install
```

## 配置

1. 将 `.env.example` 文件复制到 `.env`:
   ```bash
   cp .env.example .env
   ```

2. 使用您的 Google API 凭据编辑 `.env` 文件：
   ```
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=http://localhost:3000/oauth2callback
   REFRESH_TOKEN=your_refresh_token
   ```

3. 如果您还没有刷新令牌，可以使用服务器提供的身份验证工具来获取一个。

## 用法

### 启动服务器

```bash
npm run dev
```

### 与 MCP Inspector 一起使用

要使用 MCP Inspector 测试服务器：

```bash
npm run inspect
```

这将在您的浏览器中打开 MCP Inspector，允许您测试所有工具和资源。

### 身份验证

如果您没有刷新令牌，请使用以下工具：

1. 使用 `generate_auth_url` 工具获取授权 URL
2. 在浏览器中打开 URL 并授权应用程序
3. 从重定向 URL 复制授权码
4. 使用 `exchange_code_for_tokens` 工具和代码来获取刷新令牌
5. 将刷新令牌添加到您的 `.env` 文件

## 可用工具

### Gmail

- `gmail_list_messages`: 列出 Gmail 邮件，带有可选过滤器
- `gmail_get_message`: 按 ID 获取特定的 Gmail 邮件
- `gmail_send_message`: 发送新的电子邮件
- `gmail_list_labels`: 列出所有 Gmail 标签
- `gmail_modify_message`: 修改邮件的标签
- `gmail_trash_message`: 将邮件移至垃圾箱
- `gmail_untrash_message`: 从垃圾箱中移除邮件
- `gmail_create_draft`: 创建草稿邮件

### 云端硬盘

- `drive_list_files`: 列出 Google 云端硬盘中的文件
- `drive_get_file`: 获取特定文件的元数据
- `drive_create_folder`: 在 Google 云端硬盘中创建一个新文件夹
- `drive_upload_file`: 将文件上传到 Google 云端硬盘

### 文档

- `docs_get_document`: 获取 Google 文档的内容
- `docs_create_document`: 创建一个新的 Google 文档
- `docs_append_text`: 将文本附加到 Google 文档

### 表格

- `sheets_get_values`: 从 Google 表格获取值
- `sheets_update_values`: 更新 Google 表格中的值
- `sheets_create_spreadsheet`: 创建一个新的 Google 表格

### 幻灯片

- `slides_create_presentation`: 创建一个新的 Google 幻灯片演示文稿
- `slides_get_presentation`: 获取有关 Google 幻灯片演示文稿的信息
- `slides_create_slide`: 在演示文稿中创建一个新幻灯片

### 日历

- `calendar_list_events`: 列出 Google 日历中的事件
- `calendar_create_event`: 在 Google 日历中创建一个新事件

### 身份验证

- `generate_auth_url`: 生成 OAuth2 授权 URL
- `exchange_code_for_tokens`: 将授权码交换为 OAuth2 令牌

## 可用资源

- `gmail://message/{messageId}`: 获取特定的 Gmail 邮件
- `gmail://thread/{threadId}`: 获取包含所有邮件的 Gmail 邮件串
- `gmail://labels`: 列出所有 Gmail 标签
- `workspace://docs/{service}`: 特定 Google Workspace API 的文档
- `workspace://auth/guide`: Google Workspace API 的身份验证指南

## 许可证

MIT