🚀 谷歌文档 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 仓库 或联系支持团队。