Google MCP服务

一种专门的模型上下文协议（MCP）服务器，可将谷歌服务（如Gmail、日历等）集成到您的AI工作流中。该服务器通过MCP实现与谷歌服务的无缝接入，使AI代理能够与Gmail、谷歌日历和其他谷歌服务进行交互。

calendar-managementcommunicationother

2.0k 查看 · 2026-07-07 更新

简介

systemprompt-mcp-google

网站 | 文档 | 博客

这是一个专门的模型上下文协议（MCP）服务器，可以将Google服务（Gmail、日历等）集成到您的AI工作流程中。此服务器通过MCP无缝访问Google服务，允许AI代理与Gmail、Google日历以及其他Google服务进行交互。

演示

YouTube 演示

先决条件

在使用此服务器之前，您需要：

一个Systemprompt API密钥（免费）：
- 在Systemprompt.io控制台注册
- 创建一个新的API密钥
- 运行服务器所需
一个兼容MCP的客户端，例如：
- Systemprompt MCP客户端
- Claude桌面版
- 或任何其他兼容MCP的客户端
Google Cloud项目设置：
- 一个Google Cloud账户
- 对所需服务启用API访问（Gmail、日历等）
- 配置OAuth2凭据

设置

1. Google Cloud设置

在Google Cloud控制台创建一个项目
启用所需的API：
- Gmail API（读取、发送、撰写、修改、标签）
- Google日历API（读取事件）
- Google Drive API（只读）
创建OAuth2凭据：
- 转到“API和服务”>“凭据”
- 创建一个OAuth 2.0客户端ID
- 设置授权重定向URI（包括http://localhost:3333/oauth2callback）
- 下载凭据JSON文件并保存为credentials/google-credentials.json

2. 服务器配置

安装包：

npm install systemprompt-mcp-google

mkdir -p credentials

运行认证脚本：

npm run auth-google

这将：

打开您的默认浏览器以进行Google OAuth认证
在端口3333上启动本地服务器以处理OAuth回调
生成并保存令牌到credentials/google-token.json
认证完成后自动关闭

脚本将请求以下权限：

Gmail：读取、发送、撰写、修改和管理标签
日历：读取事件和日历
Drive：只读访问

3. MCP客户端设置

选择您喜欢的MCP客户端：

使用Systemprompt MCP客户端

根据其设置说明安装和配置客户端
在客户端的MCP配置中添加此服务器：

{
  "servers": {
    "google": {
      "type": "stdio",
      "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
    }
  }
}

注意：将your_api_key替换为您从Systemprompt.io控制台获取的实际Systemprompt API密钥。

使用 Claude 桌面版

安装 Claude 桌面版

在 Claude 的 MCP 配置部分使用 API 密钥添加此服务器：

{
  "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
}

配置连接以使用 stdio 模式

功能

Google 服务集成

Gmail 集成
- 通过 MCP 命令读取和发送邮件
- 管理草稿和附件
- 搜索和过滤邮件
- 处理邮件线程
日历集成
- 通过 MCP 命令创建和管理事件
- 处理事件邀请
- 搜索和过滤日历事件
- 管理多个日历

MCP 集成

标准 MCP 接口
- 与任何符合 MCP 标准的客户端兼容
- 结构化的命令响应
- 错误处理和状态报告
- 会话管理

安全性和身份验证

安全的 OAuth2 身份验证流程
自动令牌刷新
不同服务的范围访问
基于环境的配置

开发特性

全面支持 TypeScript
综合错误处理
广泛的测试覆盖
符合 MCP 标准的接口

配置

设置 Google Cloud 项目和 OAuth2 凭证：
- 在 Google Cloud 控制台中创建一个项目
- 启用 Gmail 和 Calendar API
- 创建 OAuth2 凭证
- 下载凭证文件
配置环境变量：

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=your_redirect_uri

运行身份验证脚本：

npm run auth-google

使用

通过 MCP 客户端

配置完成后，您可以使用任何 MCP 客户端向该服务器发送命令。示例交互：

Gmail 操作

// Example MCP command structure for sending an email
{
  "command": "gmail.sendEmail",
  "parameters": {
    "to": "recipient@example.com",
    "subject": "Hello from MCP",
    "body": "This email was sent via MCP!"
  }
}

// Example MCP command for listing messages
{
  "command": "gmail.listMessages",
  "parameters": {
    "maxResults": 10
  }
}

日历操作

// Example MCP command for creating an event
{
  "command": "calendar.createEvent",
  "parameters": {
    "summary": "Team Meeting",
    "start": "2024-03-01T10:00:00",
    "end": "2024-03-01T11:00:00",
    "attendees": ["team@company.com"]
  }
}

// Example MCP command for listing events
{
  "command": "calendar.listEvents",
  "parameters": {
    "timeMin": "2024-03-01T00:00:00Z",
    "maxResults": 10
  }
}

测试

该项目包括针对 MCP 协议处理和 Google 服务集成的全面测试：

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

调试 MCP 通信

由于 MCP 服务器通过 stdio 通信，调试需要特别注意：

使用 MCP Inspector：

npm run inspector

启用调试日志记录：

# Set environment variable
DEBUG=mcp:* npm run dev

使用提供的测试客户端：

npm run test:client

许可证

MIT

开发

本地开发设置

克隆仓库：

git clone https://github.com/yourusername/systemprompt-mcp-google.git
cd systemprompt-mcp-google

安装依赖项：

npm install

设置环境变量：

# Copy example environment file
cp .env.example .env

# Edit .env and add:
SYSTEMPROMPT_API_KEY=your_api_key  # Required - get from systemprompt.io/console

设置 Google 凭证：

将您的 Google OAuth 凭证保存为 credentials/google-credentials.json
运行 npm run auth-google 以使用 Google 进行身份验证

启动开发服务器：

npm run dev

来源

来源：github
链接：https://github.com/Ejb503/systemprompt-mcp-google