使用说明
@suncreation/mcp谷歌文档
用于Google文档、表格和驱动器的MCP服务器，具有完整的格式支持。
叉子 a-bonus/谷歌文档mcp 随着 固定OAuth流 （用localhost重定向替换了弃用的OOB）。
npx快速入门
npx @suncreation/mcp-google-docs
安装
选项1：环境变量（建议用于npx）
{
"mcpServers": {
"google-docs": {
"command": "npx",
"args": ["-y", "@suncreation/mcp-google-docs"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"TOKEN_PATH": "/path/to/token.json"
}
}
}
}
选项2:credentials.json文件
{
"mcpServers": {
"google-docs": {
"command": "npx",
"args": ["-y", "@suncreation/mcp-google-docs"],
"env": {
"CREDENTIALS_PATH": "/path/to/credentials.json",
"TOKEN_PATH": "/path/to/token.json"
}
}
}
}
首次运行：OAuth身份验证
首次运行时，将打开一个浏览器窗口进行谷歌身份验证。批准后， token.json 保存以备将来使用。
特性
谷歌文件
- 读/写文档
- 文本格式（粗体、斜体、颜色）
- 段落样式（对齐、间距）
- 表格、图片、分页符
- 评论管理
谷歌表格
- 读/写电子表格
- 添加行，清除范围
- 创建电子表格，添加表格
Google 云端硬盘
- 列出、搜索、创建文档
- 文件夹管理
- 移动、复制、重命名、删除文件
环境变量
| 变量 | 描述 |
|---|---|
GOOGLE_CLIENT_ID |
OAuth客户端ID |
GOOGLE_CLIENT_SECRET |
OAuth客户端密码 |
CREDENTIALS_PATH |
credentials.json的路径（可替代上述路径） |
TOKEN_PATH |
保存/加载token.json的路径 |
SERVICE_ACCOUNT_PATH |
服务帐户密钥的路径（适用于企业） |
GOOGLE_IMPERSONATE_USER |
要冒充的电子邮件（使用服务帐户） |
谷歌云设置
- 首选 谷歌云控制台
- 创建项目
- 启用API：Google Docs API、Google Sheets API、Google Drive API
- 创建OAuth 2.0凭据（桌面应用程序）
- 重要：添加
http://localhost:3000/oauth2callback到授权重定向URI - 下载credentials.json或复制客户端ID/密码
许可证
麻省理工学院-基于 a-bonus/谷歌文档mcp
