🚀 Google 工作区 MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供了与 Gmail 和日历 API 交互的工具。借助该服务器，您能够通过 MCP 接口对电子邮件和日历事件进行编程管理。

🚀 快速开始

本服务器可帮助您通过 MCP 接口对电子邮件和日历事件进行编程管理，以下为您介绍具体的安装和使用方法。

📦 安装指南

安装

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd google-workspace-mcp-server
   

2. 安装依赖项：

   npm install
   

配置

1. 创建配置文件：
   • 在项目根目录下创建 config.json 文件。
   • 添加以下内容：

     {
       "google": {
         "client_id": "your_client_id",
         "client_secret": "your_client_secret",
         "refresh_token": "your_refresh_token"
       }
     }
     

2. 设置环境变量：
   • 确保安装了 Node.js 和 npm。
   • 安装依赖项后，运行服务器：

     npm start
     

💻 使用示例

Gmail 操作

基础用法

以下是一些常见的 Gmail 操作示例：

• 获取邮件

{
  "maxResults": 5,
  "query": "is:unread"
}

• 搜索邮件

{
  "query": "from:example@gmail.com has:attachment",
  "maxResults": 10
}

高级用法

• 发送邮件

{
  "to": "收件人@example.com",
  "subject": "主题",
  "body": "邮件正文",
  "cc": "抄送@example.com",
  "bcc": "密送@example.com"
}

• 修改邮件标签

{
  "id": "邮件ID",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

日历操作

基础用法

• 获取事件

{
  "maxResults": 10,
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z"
}

高级用法

• 创建事件

{
  "summary": "会议标题",
  "location": "会议室",
  "description": "会议描述",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["参与者@example.com"]
}

注意事项

⚠️ 重要提示

• 确保所有 OAuth 2.0 凭证正确配置。
• 检查 Google Cloud Console 中的 API 配额和限制。

📚 详细文档

常见问题

1. 认证问题：

   • 确保所有所需的 OAuth 范围已授予。
   • 验证客户端 ID 和密钥是否正确。
   • 检查刷新令牌是否有效。

2. API 错误：

   • 检查 Google Cloud Console 中的 API 配额和限制。
   • 确保已启用所需 API。
   • 验证请求参数是否符合要求格式。

📄 许可证

此项目根据 MIT 许可证授权。