🚀 Google Docs MCP 服务器

Google Docs MCP 服务器是一个中间件平台，用于与 Google 文档 API 进行交互。它支持通过命令对 Google 文档进行创建、读取、更新和删除等操作，同时还具备导出、共享和搜索等实用功能。

🚀 快速开始

Google Docs MCP 服务器为您与 Google 文档 API 的交互提供了便捷途径。您可以通过一系列命令轻松实现对 Google 文档的各种操作。

✨ 主要特性

• 支持对 Google 文档进行创建、读取、更新和删除操作。
• 具备文档导出、共享和搜索功能。
• 提供多种认证方式，包括使用 Google Cloud Project ID 和 Service Account Key JSON、API Key 以及 OAuth 2.0。
• 支持 Docker 部署，方便快捷。
• 可集成到 Claude 或其他支持 MCP 的助手中。

📦 安装指南

安装依赖项

使用以下命令安装所需的依赖项：

npm install

运行服务器

运行服务器：

node dist/index.js

🔧 认证配置

要与 Google Docs API 交互，您需要适当的认证信息。以下是支持的几种认证方式：

1. 使用 Google Cloud Project ID 和 Service Account Key JSON

• 参数:
  • GOOGLE_CLOUD_PROJECT_ID：您的 Google Cloud 项目 ID。
  • GOOGLE_APPLICATION_CREDENTIALS：包含您的服务账户密钥的 JSON 文件路径。

    export GOOGLE_CLOUD_PROJECT_ID=your-project-id
    export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
    

2. 使用 API Key

• 参数:
  • GOOGLE_API_KEY：您的 Google API 密钥。

    export GOOGLE_API_KEY=your-api-key
    

3. 使用 OAuth 2.0（适用于用户认证）

• 参数:
  • client_id：您的应用客户端 ID。
  • client_secret：您的应用客户端密钥。
  • refresh_token：用户的刷新令牌。

    export client_id=your-client-id
    export client_secret=your-client-secret
    export refresh_token=your-refresh-token
    

🐳 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_JSON='{"type":"service_account","project_id":"..."}' \
  -e client_id=your-client-id \
  -e client_secret=your-client-secret \
  -e refresh_token=your-refresh-token \
  -e AUTH_SERVER_URL=https://your-auth-server.com/verify \
  google-docs-mcp-server

🔌 MCP 集成

要在 Claude 或其他支持 MCP 的助手中使用此服务器，将其添加到 MCP 设置：

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": ["/path/to/google-docs-mcp-server/dist/index.js"],
      "config": {
        "GOOGLE_CLOUD_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}

🛠️ 可用工具

以下是可通过服务器进行的操作：

💻 使用示例

基础用法

创建新文档

{
  "command": "createDocument",
  "params": {
    "documentTitle": "My New Document",
    "body": "This is the content of the new document."
  }
}

更新现有文档

{
  "command": "updateDocument",
  "params": {
    "id": "1234567890abcdefghijklmnopqrstuvwxyz",
    "newBody": "Updated content of the document."
  }
}

📄 许可证

本项目采用 MIT 许可证，详情请查阅 LICENSE 文件。