Google Workspace MCP Server

Google Workspace MCP Server

用于与 Google Workspace API 交互的模型上下文协议（MCP）服务，涵盖 Gmail、Drive、Calendar、Docs、Sheets 和 Slides。

## 功能

- **Gmail API**：发送邮件、列出邮件、管理标签等
- **Drive API**：列出文件、创建文件夹和上传文件
- **Docs API**：创建和编辑 Google Docs
- **Sheets API**：读取和写入电子表格数据
- **Slides API**：创建演示文稿和幻灯片
- **Calendar API**：列出和创建日历活动
- **身份验证**：OAuth2 身份验证流程辅助工具

## 先决条件

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

## 安装

```bash
npm install
```

## 配置

1. 将 `.env.example` 文件复制为 `.env`：
   ```bash
   cp .env.example .env
   ```

2. 在 `.env` 文件中填写 Google API 凭据：
   ```
   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

- `drive_list_files`：列出 Google Drive 中的文件
- `drive_get_file`：获取指定文件的元数据
- `drive_create_folder`：在 Google Drive 中创建新文件夹
- `drive_upload_file`：将文件上传到 Google Drive

### Docs

- `docs_get_document`：获取 Google Doc 的内容
- `docs_create_document`：创建新的 Google Doc
- `docs_append_text`：向 Google Doc 追加文本

### Sheets

- `sheets_get_values`：获取 Google Sheet 中的值
- `sheets_update_values`：更新 Google Sheet 中的值
- `sheets_create_spreadsheet`：创建新的 Google Sheet

### Slides

- `slides_create_presentation`：创建新的 Google Slides 演示文稿
- `slides_get_presentation`：获取 Google Slides 演示文稿的信息
- `slides_create_slide`：在演示文稿中创建新幻灯片

### Calendar

- `calendar_list_events`：列出 Google Calendar 中的活动
- `calendar_create_event`：在 Google Calendar 中创建新活动

### 身份验证

- `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