返回 MCP 目录
public公开dns本地运行

google-docs-mcp-server-usd

一个实现Google Docs API集成的MCP服务器,支持文档的创建、读取、更新和管理等操作。

article

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 仓库 或联系支持团队。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端