附件gmailmcp
用于RAM编排层的Gmail MCP服务器。通过模型上下文协议提供电子邮件读取、起草和发送功能。
概述
此MCP服务器包含Gmail API功能，供 RAM（远程代理管理器）它遵循架构原则：
- 独立MCP服务器 -RAM配置并调用此服务器
- 外部数据保持在外部 -无电子邮件存储；按需取货
- 信任模型执行 -发送操作需要明确批准
建筑
+------------------+ +-------------------+ +---------+
| RAM | --> | annex-gmail-mcp | --> | Gmail |
| (orchestration) | | (MCP server) | | API |
+------------------+ +-------------------+ +---------+RAM拥有：
- MCP服务器配置(
.mcp.json) - 何时呼叫MCP服务器
- 信任模型执行（发送批准）
- 生活中的草稿存储(
drafts/email/)
此服务器提供：
- 通过MCP工具抽象Gmail API
- OAuth2身份验证流程
- 读取、搜索、起草、发送功能
MCP工具
| 工具 | 说明 | 需要批准 |
|---|---|---|
gmail_list_messages | 列出最近的电子邮件 | 否 |
gmail_search | 按查询搜索电子邮件 | 否 |
gmail_get_message | 获取完整的电子邮件内容 | 否 |
gmail_create_draft | 在Gmail中创建草稿 | 否 |
gmail_send | 发送电子邮件 | 是 （RAM强制执行） |
gmail_list_labels | 列出Gmail标签 | 否 |
设置
看 docs/setup.md 有关详细的设置说明：
- 创建GCP项目并启用Gmail API
- 配置OAuth同意屏幕
- 创建OAuth凭据
- 安装并配置MCP服务器
- 添加到RAM
.mcp.json
RAM集成
添加到RAM .mcp.json:
{
"mcpServers": {
"gmail": {
"command": "node",
"args": ["/path/to/annex-gmail-mcp/dist/index.js"],
"env": {
"GOOGLE_CREDENTIALS_PATH": "~/.config/ram/google-credentials.json",
"GOOGLE_TOKEN_PATH": "~/.config/ram/google-token.json"
}
}
}
}信任模型
RAM执行信任模型，而不是此MCP服务器：
| 行动 | MCP工具 | RAM行为 |
|---|---|---|
| 阅读电子邮件 | gmail_list_messages, gmail_get_message | 直拨电话 |
| 搜索电子邮件 | gmail_search | 直拨电话 |
| 创建草稿 | gmail_create_draft | 直拨电话 |
| 发送电子邮件 | gmail_send | 需要用户批准 |
审批流程：
- 克劳德起草电子邮件至
life-os/drafts/email/ - RAM向用户展示草稿
- 用户明确批准（“发送”、“批准”）
- RAM调用
gmail_send