systemprompt-mcp-google
网站|文档|博客
一个专用的模型上下文协议 (MCP) 服务器，可将 Google 服务（Gmail、Google 日历等）集成到您的 AI 工作流程中。该服务器支持通过 MCP 无缝访问 Google 服务，从而使 AI 代理能够与 Gmail、Google 日历和其他 Google 服务进行交互。
演示
YouTube 演示
先决条件
在使用此服务器之前，您需要：
- Systemprompt API 密钥（免费）：
- 与 MCP 兼容的客户端，例如：
- Google Cloud 项目设置：
- Google Cloud 帐户
- 为所需服务（Gmail、日历等）启用 API 访问
- OAuth2 凭据已配置
设置
1. Google Cloud 设置
- 在Google Cloud Console中创建项目
- 启用您需要的 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
- 创建凭证目录：
- 运行身份验证脚本：
这将：
- 打开默认浏览器进行 Google OAuth 身份验证
- 在端口 3333 上启动本地服务器来处理 OAuth 回调
- 生成令牌并将其保存到
credentials/google-token.json - 身份验证完成后自动关闭
该脚本将请求以下权限：
- Gmail：阅读、发送、撰写、修改和管理标签
- 日历：读取事件和日历
- 驱动器：只读访问
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/console的实际 Systemprompt API 密钥。
使用 Claude Desktop
- 安装 Claude Desktop
- 使用 API 密钥在 Claude 的 MCP 配置部分中添加此服务器：
{
"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_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=your_redirect_uri
- 运行身份验证脚本：
用法
通过 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 检查器：
- 启用调试日志记录：
# Set environment variable
DEBUG=mcp:* npm run dev
- 使用提供的测试客户端：
执照
麻省理工学院
相关项目
发展
本地开发设置
- 克隆存储库：
git clone https://github.com/yourusername/systemprompt-mcp-google.git
cd systemprompt-mcp-google
- 安装依赖项：
- 设置环境变量：
# 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 进行身份验证
- 启动开发服务器：