谷歌工作区 MCP 服务器

功能介绍

邮件操作

• 最近邮件列表

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

• 邮件搜索

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

• 发送邮件

  {
    "to": "recipient@example.com",
    "subject": "Hello",
    "body": "Message content",
    "cc": "cc@example.com",
    "bcc": "bcc@example.com"
  }
  

• 修改邮件标签

  {
    "id": "message_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": ["colleague@example.com"]
  }
  

• 更新日程

  {
    "eventId": "event_id",
    "summary": "更新后的会议标题",
    "location": "虚拟会议室",
    "start": "2024-01-24T11:00:00Z",
    "end": "2024-01-24T12:00:00Z"
  }
  

• 删除日程

  {
    "eventId": "event_id"
  }
  

必要条件

1. 安装 Node.js 和 npm。
2. 配置 Google Workspace 开发者凭据。
3. 确保已启用 Gmail API 和 Calendar API。

设置步骤

项目初始化

npm init -y

安装依赖项

npm install express cors @google/googleapis

创建配置文件

创建 config.js：

const config = {
    google: {
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET',
        refreshToken: 'YOUR_REFRESH_TOKEN'
    }
};

module.exports = config;

实现 API 调用

参考代码示例：

const {google} = require('googleapis');
const config = require('./config');

function gmailApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId, 
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 实现具体的 API 调用逻辑
}

function calendarApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId,
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 实现具体的日历 API 调用逻辑
}

项目构建

npm run build

运行命令

npm start

常见问题排查

• 无法启动服务？
  检查端口是否被占用或配置文件是否有误。

• API 请求失败？
  确保凭据有效且网络连接正常。

• 日志信息不足？
  启用详细日志记录以获取更多调试信息。

文档参考

• Node.js 官方文档
• 谷歌 APIs 节点库
• Gmail API 文档
• Calendar API 文档