README
🚀 谷歌文档 MCP 服务器指南
本指南详细介绍了谷歌文档 MCP 服务器的安装、配置、启动方法,以及可用工具和示例用法,帮助你快速上手该服务器。
🚀 快速开始
你可以按照以下步骤快速启动谷歌文档 MCP 服务器。
📦 安装指南
使用 npm 安装
npm install google-docs-mcp-server
克隆仓库
git clone https://github.com/your-repository/google-docs-mcp-server.git
cd google-docs-mcp-server
📚 详细文档
配置说明
通过设置以下环境变量来配置服务器:
| 环境变量名 | 类型 | 说明 |
|------------|------|------|
| GOOGLE_CLOUD_PROJECT_ID | 字符串 | 谷歌云项目 ID,用于身份验证 |
| GOOGLE_APPLICATION_CREDENTIALS | 字符串 | 服务账户密钥文件路径或内容 |
| GOOGLE_API_KEY | 字符串 | 谷歌 API 密钥 |
| client_id | 字符串 | OAuth 凭证客户 ID |
| client_secret | 字符串 | OAuth 凭证客户密码 |
| refresh_token | 字符串 | OAuth 刷新令牌 |
服务器启动
使用 Node.js 启动
node dist/index.js
设置环境变量并运行
GOOGLE_CLOUD_PROJECT_ID=your-project-id \
GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json" \
client_id="your-oauth-client-id" \
client_secret="your-oauth-client-secret" \
refresh_token="your-oauth-refresh-token" \
node dist/index.js
Docker 支持
构建 Docker 镜像
docker build -t google-docs-mcp-server .
运行容器
docker run -p 8080:8080 \
-e GOOGLE_CLOUD_PROJECT_ID=your-project-id \
-e GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json" \
-e GOOGLE_API_KEY="your-api-key" \
-e client_id="your-oauth-client-id" \
-e client_secret="your-oauth-client-secret" \
-e refresh_token="your-oauth-refresh-token" \
google-docs-mcp-server
可用工具
| 工具名称 | 描述 | 必要参数 |
|----------|------|----------|
| google_docs_create | 创建新谷歌文档 | title, content (可选) |
| google_docs_get | 通过 ID 获取谷歌文档 | documentId |
| google_docs_update | 更新现有内容 | documentId, content, replaceAll (可选) |
| google_docs_list | 列出所有可访问的文档 | pageSize (可选), pageToken (可选) |
| google_docs_delete | 删除文档 | documentId |
| google_docs_export | 导出为其他格式 | documentId, mimeType (可选) |
| google_docs_share | 分享给特定用户 | documentId, emailAddress, role (可选) |
| google_docs_search | 根据标题或内容搜索文档 | query, pageSize (可选), pageToken (可选) |
💻 使用示例
基础用法
创建新文档
{
"tool": "google_docs_create",
"params": {
"title": "我的新文档",
"content": "欢迎使用谷歌文档!"
}
}
搜索文档
{
"tool": "google_docs_search",
"params": {
"query": "项目报告",
"pageSize": 10,
"pageToken": "abc123"
}
}
📄 许可证
本项目遵循 MIT 协议。查看 LICENSE 文件获取详细信息。
如需进一步帮助,请参考我们的 GitHub 仓库 或联系支持团队。
微信扫一扫