AI导哈

谷歌服务集成协议服务器

一个专为AI工作流设计的Model Context Protocol (MCP)服务器，通过MCP协议无缝集成Gmail、Google日历等谷歌服务，使AI代理能够与谷歌服务交互。

  • by ajacobm
  • 本地部署
  • 更新于
在 GitHub 查看 ajacobm/systemprompt-mcp-google

使用说明

系统提示mcp谷歌

网站 | 文档 | 博客

一个专门的模型上下文协议（MCP）服务器，将谷歌服务（Gmail、日历等）集成到您的人工智能工作流程中。该服务器通过MCP实现了对谷歌服务的无缝访问，允许人工智能代理与Gmail、谷歌日历和其他谷歌服务进行交互。

演示

YouTube演示

先决条件

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

  1. 系统提示API密钥（免费）：

  2. MCP兼容客户端，如：

  3. 谷歌云项目设置：

    • Google Cloud帐户
    • 为所需服务（Gmail、日历等）启用API访问
    • 已配置OAuth2凭据

设置

1.谷歌云设置

  1. 在中创建项目 谷歌云控制台
  2. 启用所需的API：
    • Gmail API（阅读、发送、撰写、修改、标记）
    • 谷歌日历API（阅读事件）
    • Google Drive API（只读）
  3. 创建OAuth2凭据：
    • 转到“API和服务”>“凭据”
    • 创建OAuth 2.0客户端ID
    • 设置授权重定向URI（包括 http://localhost:3333/oauth2callback)
    • 下载凭据JSON文件并将其另存为 credentials/google-credentials.json

2.服务器配置

  1. 安装软件包：
npm install systemprompt-mcp-google
  1. 创建凭据目录：
mkdir -p credentials
  1. 运行身份验证脚本：
npm run auth-google

这将：

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

脚本将请求以下权限：

  • Gmail：阅读、发送、撰写、修改和管理标签
  • 日历：读取事件和日历
  • 驱动器：只读访问

3.MCP客户端设置

选择您喜欢的MCP客户端：

使用Systemprompt MCP客户端

  1. 按照以下步骤安装和配置客户端 安装说明
  2. 在客户端的MCP配置中，添加此服务器：
{
  "servers": {
    "google": {
      "type": "stdio",
      "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
    }
  }
}

注：更换 your_api_key 使用来自的实际Systemprompt API密钥 systemprompt.io/控制台.

使用克劳德桌面

  1. 安装克劳德桌面
  2. 使用API密钥在Claude的MCP配置部分中添加此服务器：
    {
  "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google"
}
  3. 配置连接以使用stdio模式

特性

谷歌服务集成

  • Gmail集成

    • 通过MCP命令读取和发送电子邮件
    • 管理草稿和附件
    • 搜索和过滤电子邮件
    • 处理电子邮件线程

  • 日历集成

    • 通过MCP命令创建和管理事件
    • 处理活动邀请
    • 搜索和筛选日历事件
    • 管理多个日历

MCP集成

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

安全和身份验证

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

发展特征

  • 完全支持TypeScript
  • 全面的错误处理
  • 广泛的测试覆盖范围
  • MCP兼容接口

配置

  1. 设置Google Cloud项目和OAuth2凭据：

    • 在中创建项目 谷歌云控制台
    • 启用Gmail和日历API
    • 创建OAuth2凭据
    • 下载凭据文件

  2. 配置环境变量：

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=your_redirect_uri
  1. 运行身份验证脚本：
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协议处理和谷歌服务集成的全面测试：

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

调试MCP通信

由于MCP服务器通过stdio进行通信，因此调试需要特别考虑：

  1. 使用MCP检查器：
npm run inspector
  1. 启用调试日志记录：
# Set environment variable
DEBUG=mcp:* npm run dev
  1. 使用提供的测试客户端：
npm run test:client

许可证

麻省理工学院

相关项目

发展

地方发展设置

  1. 克隆存储库：
git clone https://github.com/yourusername/systemprompt-mcp-google.git
cd systemprompt-mcp-google
  1. 安装依赖项：
npm install
  1. 设置环境变量：
# Copy example environment file
cp .env.example .env

# Edit .env and add:
SYSTEMPROMPT_API_KEY=your_api_key  # Required - get from systemprompt.io/console
  1. 设置Google凭据：
  • 将您的Google OAuth凭据另存为 credentials/google-credentials.json
  • 跑 npm run auth-google 通过Google进行身份验证
  1. 启动开发服务器：
npm run dev

相关 MCP