Google Workspace文档协议服务

基于Cloudflare Workers的Google Workspace文档协议服务,支持与Google Docs、Sheets和Drive交互,允许AI助手安全访问和管理文档。

  • by NolanFoster
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 NolanFoster/google-workspace-mcp-cloudflare

使用说明

Cloudflare Workers上的谷歌工作区MCP

这是一个在Cloudflare Workers上运行的模型上下文协议(MCP)服务器,与Google文档、表格和驱动器交互。它允许Claude Desktop、Cursor等AI助手安全地访问和管理您的Google Workspace文档。

特性

  • Google 云端硬盘:使用搜索和列出文件 listDriveFiles.
  • 谷歌文档:
    • 使用读取文档内容 readDocument.
    • 使用创建新文档 createDocument.
    • 在文档中添加文本 appendDocumentText.
    • 列出文档选项卡 listDocumentTabs.
  • 谷歌表格:从具有的范围中读取值 readSheet.

设置

1.谷歌云控制台配置

  1. 去 谷歌云控制台.
  2. 创建一个新项目。
  3. 启用以下API:
    • Google Drive API
    • 谷歌文档API
    • 谷歌网页API
  4. 首选 API和服务>凭据.
  5. 创建一个 OAuth 2.0客户端ID (Web应用程序)。
  6. 添加 http://localhost:8787/oauth/callback 到 授权重定向URI.
  7. 记下你的 客户端ID 和 客户端密钥.

2.配置和秘密

  1. 创建KV命名空间:
    npx wrangler kv:namespace create GOOGLE_AUTH_KV
    
  2. 更新您的 wrangler.jsonc 使用KV命名空间ID。
  3. 设置您的Google OAuth机密:
    npx wrangler secret put GOOGLE_CLIENT_ID
    npx wrangler secret put GOOGLE_CLIENT_SECRET
    

3.部署

npm install
npm run deploy

认证

一旦部署(或在本地运行 npm run dev),请访问以下URL以使用您的Google帐户进行身份验证:

http://localhost:8787/oauth/login (或您部署的工作URL)

这将安全地将您的刷新令牌存储在Cloudflare KV中。

MCP配置

将以下内容添加到MCP客户端配置中(例如。, claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/sdk-server-sse", "http://localhost:8787/mcp"]
    }
  }
}

发展

npm run dev