使用说明
Auralis谷歌
用于Google Workspace与Claude AI集成的MCP服务器
Auralis Google通过模型上下文协议(MCP)在Claude AI和Google Workspace服务之间提供无缝集成。直接从Claude访问Gmail、日历、驱动器、文档和表格。
特性
- Gmail:搜索邮件、阅读电子邮件、发送电子邮件、管理标签
- 日历:列出事件、创建/更新/删除事件、列出日历
- 驾驶:列出文件、搜索、读取内容、创建/删除文件和文件夹
- 文档:读取文档、附加文本、创建新文档
- 表格:完整的电子表格管理-读取、写入、追加、删除行、管理工作表
安装
选项1:npm(推荐)
npm install -g auralis-google
选项2:Docker
docker pull antonpme/auralis-google
docker run -p 3000:3000 \
-e GOOGLE_CLIENT_ID=your_client_id \
-e GOOGLE_CLIENT_SECRET=your_client_secret \
-e GOOGLE_REDIRECT_URI=http://localhost:3000/oauth/callback \
antonpme/auralis-google
选项3:克隆和构建
git clone https://github.com/antonpme/auralis-google.git
cd auralis-google
npm install
npm run build
谷歌云设置
在使用Auralis Google之前,您需要创建OAuth凭据:
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用以下API:
- Gmail API
- 谷歌日历API
- Google Drive API
- 谷歌文档API
- 谷歌网页API
- 首选 凭证 → 创建凭证 → OAuth客户端ID
- 选择 Web应用程序
- 添加授权重定向URI:
http://localhost:3000/oauth/callback - 复制 客户端ID 和 客户端密钥
配置
克劳德桌面(stdio模式)
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"google": {
"command": "auralis-google",
"env": {
"MCP_MODE": "stdio",
"GOOGLE_CLIENT_ID": "your_client_id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your_client_secret",
"GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth/callback"
}
}
}
}
HTTP模式(铁路/Docker)
设置这些环境变量:
| 变量 | 描述 |
|---|---|
PORT |
服务器端口(默认值:3000) |
MCP_MODE |
设置为 http 用于HTTP模式(默认) |
GOOGLE_CLIENT_ID |
OAuth客户端ID |
GOOGLE_CLIENT_SECRET |
OAuth客户端密码 |
GOOGLE_REDIRECT_URI |
OAuth回调URL |
TOKENS_PATH |
存储令牌的路径(默认值: ./data/tokens.json) |
HTTP端点:
| 端点 | 方法 | 描述 |
|---|---|---|
/mcp |
POST | MCP协议端点(可流式HTTP) |
/auth?account=xxx |
GET | 启动帐户的OAuth流 |
/oauth/callback |
GET | OAuth回调处理程序 |
/health |
GET | 健康检查 |
认证
首次使用时,您需要向Google进行身份验证:
HTTP模式:
- 打开
http://localhost:3000/auth?account=personal浏览器中 - 使用您的Google帐户登录
- 授予权限
- 你会看到“✅ 身份验证为your@email.com"
标准模式: 您需要先在HTTP模式下运行服务器以完成OAuth,然后切换到stdio。
多个帐户
您可以验证多个Google帐户:
/auth?account=personal
/auth?account=work
/auth?account=client
然后在使用工具时指定帐户:
{
"account": "work",
"query": "is:unread"
}
工具参考
账户管理
| 工具 | 说明 |
|---|---|
google_list_accounts |
列出所有经过身份验证的Google帐户 |
Gmail(4个工具)
| 工具 | 说明 |
|---|---|
google_gmail_search |
使用查询搜索Gmail邮件 |
google_gmail_read |
按ID阅读特定电子邮件 |
google_gmail_send |
发送电子邮件 |
google_gmail_labels |
列出Gmail标签 |
日历(5个工具)
| 工具 | 说明 |
|---|---|
google_calendar_list |
列出所有日历 |
google_calendar_list_events |
使用可选时间过滤器列出事件 |
google_calendar_create_event |
创建新事件 |
google_calendar_update_event |
更新现有事件 |
google_calendar_delete_event |
删除事件 |
驱动器(8个工具)
| 工具 | 说明 |
|---|---|
google_drive_list |
列出驱动器或文件夹中的文件 |
google_drive_search |
按内容搜索文件 |
google_drive_get |
获取文件元数据 |
google_drive_read |
读取文件内容(文本/Google文档) |
google_drive_create |
创建新文件 |
google_drive_delete |
删除文件 |
google_drive_create_folder |
创建文件夹 |
google_drive_move |
将文件移动到另一个文件夹 |
文档(3个工具)
| 工具 | 说明 |
|---|---|
google_docs_read |
阅读谷歌文档 |
google_docs_append |
在文档中添加文本 |
google_docs_create |
创建新的Google文档 |
表格(10个工具)
| 工具 | 说明 |
|---|---|
google_sheets_create |
创建新的电子表格 |
google_sheets_read |
从范围读取数据 |
google_sheets_append |
将行附加到工作表 |
google_sheets_update |
更新范围内的单元格 |
google_sheets_info |
获取电子表格元数据 |
google_sheets_delete_rows |
删除行 |
google_sheets_clear |
清除范围内的单元格 |
google_sheets_add_sheet |
添加新图纸选项卡 |
google_sheets_delete_sheet |
删除图纸选项卡 |
google_sheets_rename_sheet |
重命名图纸选项卡 |
用法示例
搜索未读电子邮件
Search my Gmail for unread messages from last week
创建日历事件
Create a meeting called "Project Review" tomorrow at 3pm for 1 hour
读取电子表格数据
Read all data from my Budget spreadsheet
发送邮件
Send an email to john@example.com with subject "Meeting Notes" and the summary of our discussion
与Google Workspace CLI的比较
谷歌发布了 谷歌工作区CLI (gws)2026年3月,一个基于Rust的CLI+MCP服务器,可以动态发现所有Google API。这是一个令人印象深刻的项目。以下是它的比较:
概览
| Auralis谷歌 | 谷歌工作区CLI | |
|---|---|---|
| 聚焦 | 生产MCP服务器 | CLI工具+MCP服务器 |
| 成熟 | 稳定,生产测试 | v1.0之前,快速迭代 |
| 语言 | TypeScript(可破解) | Rust(二进制,不可修改) |
| 运输 | HTTP流媒体+标准 | 仅限标准 |
| 远程部署 | ✅ 铁路、Docker、任何云❌ 仅限本地 | |
| 谷歌服务 | 5(Gmail、日历、驱动器、文档、表格) | 26+(自动发现) |
| MCP工具 | 31(聚焦) | 200-400全/~26紧凑型 |
| 多账户 | ✅ 稳定 | ⚠️ 记录在案的身份验证问题 |
| 自定义OAuth应用程序 | ✅ 您自己的GCP项目 | ✅ 您自己的GCP项目 |
| 范围控制 | 5个范围,始终在限制范围内 | 85+推荐,达到未经验证的应用上限 |
| 谷歌官方产品 | 否 | 否(“未得到官方支持”) |
为什么选择Auralis谷歌
1.远程优先架构
Auralis Google在Railway、Docker或任何云提供商上运行。你的人工智能助手可以从任何地方访问谷歌API,而不仅仅是你的本地机器。 gws MCP模式仅在stdio(本地进程)上工作。
2.生产稳定
跨多个帐户的真实使用情况。没有身份验证循环,没有令牌刷新问题,没有范围冲突。 gws 正在积极开发中 开放式身份验证相关问题.
3.刀具表面尺寸合适
31个专门构建的工具,涵盖了谷歌工作区的核心工作流程。你的AI不会燃烧加载200多个工具定义的上下文令牌。每个工具都有明确的输入模式和Zod验证。
4.可被黑客攻击
你可以阅读、修改和扩展TypeScript源代码。需要定制工具吗?将其添加到20行中。Rust二进制文件不提供这种灵活性。
什么时候考虑gws
- 您需要核心5之外的谷歌服务(幻灯片、表单、任务、会议、聊天、保留、管理员)
- 您希望CLI访问Google API(而不仅仅是MCP)
- 您更喜欢一个工具来处理所有事情,不需要远程部署
- 您对v1.0之前的软件很熟悉,可以解决身份验证问题
摘要
| 场景 | 建议 |
|---|---|
| 用于AI助手的生产MCP服务器 | Auralis谷歌 |
| 用于快速调用Google API的本地CLI | gws |
| 需要幻灯片、表格、任务或会议 | gws (或添加到Auralis谷歌) |
| 多机/云部署 | Auralis谷歌 |
| 想要修改或扩展代码 | Auralis谷歌 |
我们的看法: 使用Auralis Google进行生产AI工作流程。留意
gws随着它的成熟,它可能会成为核心5之外服务的有力补充。
铁路部署
- 分叉此存储库
- 连接到铁路
- 在铁路仪表板中设置环境变量
- 部署
或者使用此仓库中包含的railway.json。
建筑
auralis-google/
├── src/
│ ├── index.ts # MCP server + Express endpoints
│ ├── auth.ts # OAuth2 management
│ └── tools/
│ ├── gmail.ts
│ ├── calendar.ts
│ ├── drive.ts
│ ├── docs.ts
│ └── sheets.ts
├── dist/ # Compiled JavaScript
├── data/ # Token storage (gitignored)
├── Dockerfile
├── railway.json
└── package.json
安全
- OAuth令牌存储在本地
./data/tokens.json - 令牌过期时会自动刷新
- 永远不要承诺你的
data/文件夹或.env文件 - 使用环境变量作为凭据
贡献
欢迎投稿!请打开问题或提交拉取请求。
许可证
MIT许可证-请参阅 许可证 文件。