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

google-docs-mcp-sse-server

一个基于MCP架构的Google Docs服务端项目,通过SSE实现实时文档变更通知,支持文档管理和权限控制。

article

README

🚀 Google 文档 MCP SSE 服务器

本服务器实现了模型 - 通道 - 表示(MCP)模式,结合服务器发送事件(SSE)技术,用于高效管理 Google Docs 文档,为用户提供便捷的文档操作体验。

🚀 快速开始

快速上手 Google 文档 MCP SSE 服务器,按照以下步骤操作,即可开启文档管理之旅。

安装

# 克隆仓库
git clone https://github.com/OrangeDogSoftware/google-docs-mcp-sse-server.git
cd google-docs-mcp-sse-server

# 安装依赖项
npm install

# 配置环境变量
cp .env.example .env

配置

  1. Google Cloud Console 创建一个项目。
  2. 启用 Google Docs API。
  3. 创建 OAuth 2.0 份数字标识。
  4. 下载并重命名 credential 文件为 credentials.json

启动

# 开发模式
npm run dev

# 生产模式
npm start

✨ 主要特性

  • 使用 Google Docs API 进行身份验证,确保文档操作的安全性。
  • 支持创建和修改文档,满足多样化的文档编辑需求。
  • 实时通过 SSE 推送更改通知,让用户及时了解文档动态。
  • 可管理访问权限,保障文档数据的隐私。
  • 记录修改历史,方便用户追溯文档的变更过程。

🔧 技术细节

该服务器遵循模型 - 通道 - 表示架构:

  • 模型:负责管理 Google Docs 文档数据,确保数据的准确存储和高效检索。
  • 通道:通过 SSE 实现模型与表示之间的通信,实现实时数据的推送。
  • 表示:通过 REST API 与客户端交互,为客户端提供统一的接口。

📚 详细文档

API 端点

| 方法 | 端点 | 描述 | |------|------|------| | GET | /api/docs | 列出所有文档 | | GET | /api/docs/:id | 获取特定文档 | | POST | /api/docs | 创建新文档 | | PUT | /api/docs/:id | 更新文档 | | DELETE | /api/docs/:id | 删除文档 | | GET | /api/sse | 连接 SSE 以接收通知 |

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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