项目简介

Google Workspace MCP 服务器是一个强大的后端服务，旨在通过Model Context Protocol (MCP) 扩展AI代理（如Claude）与Google Workspace服务的集成能力。它允许AI直接访问和管理Google云端硬盘中的文件和文件夹、操作Google表格（包括数据读写、格式设置、图表创建等），以及编辑Google文档内容和样式。通过提供丰富的工具集，本服务器使得AI代理能够更智能、更高效地自动化Google Workspace相关的任务，极大地提升了工作效率。

主要功能点

Google 云端硬盘管理: 查找、创建、复制、移动、删除文件和文件夹；获取文件元数据和权限；管理文件共享；查看存储配额。
Google 表格自动化: 创建、删除、重命名电子表格和工作表；添加、删除、更新行和列；读写单元格数据；应用条件格式、自定义单元格样式；插入图表；排序、筛选数据；合并/取消合并单元格；设置行高列宽。
Google 文档编辑: 获取文档内容和元数据；追加、插入、删除文本；查找文本索引；应用文本和段落样式；设置列表样式；插入超链接、删除超链接；导出文档到其他格式。
用户认证: 通过OAuth2协议安全地连接用户的Google账户，实现对Google Workspace资源的授权访问。

安装步骤

克隆仓库: 打开终端，运行以下命令克隆项目到本地：

git clone https://github.com/chayan-1906/Google-Workspace-MCP.git
cd Google-Workspace-MCP

安装依赖: 运行以下命令安装所有必要的项目依赖：
```
npm install
```
配置环境变量:
- 在项目根目录下创建 '.env' 文件（如果不存在）。
- 根据 'src/config/config.ts' 中的变量，在 '.env' 文件中设置以下配置项：
  - 'PORT': 服务器监听端口，默认为 '20251'。
  - 'CLIENT_ID', 'CLIENT_SECRET': 从Google Cloud Console获取的OAuth客户端ID和密钥。
  - 'REDIRECT_URI': OAuth回调URI，默认为 'http://localhost:20251/oauth2callback'。
  - 'MONGODB_URI': MongoDB连接字符串，用于存储用户Token和会话。
  - 'TOKEN_SECRET': 用于加密和解密存储在MongoDB中的OAuth Token的密钥。
启动服务器:
- 开发模式：
```
npm run dev
```
- 编译并运行生产版本：
```
npm run package
```
  （这将生成一个位于 'dist/' 目录下的可执行文件 'google-workspace'）。

服务器配置 (针对MCP客户端)

MCP客户端需要以下JSON格式的配置来连接此服务器。请将 'command' 中的路径替换为您的实际可执行文件路径：

{
  "name": "Google Workspace",
  "command": "/path/to/your/Google-Workspace-MCP/dist/google-workspace",
  "args": [],
  "description": "连接到Google Workspace（云端硬盘、表格、文档）以执行AI代理任务。"
}

'name': 服务器的显示名称，例如 "Google Workspace"。
'command': 指向编译后的服务器可执行文件的完整路径（例如，在macOS上可能是 '/Users/YourUser/Google-Workspace-MCP/dist/google-workspace'，在Windows上可能是 'C:\Users\YourUser\Google-Workspace-MCP\dist\google-workspace.exe'）。
'args': 启动服务器时传递的额外参数，目前为空数组。
'description': 服务器的简要描述。

基本使用方法

启动MCP服务器。
通过浏览器访问 'http://localhost:20251/auth' 完成Google OAuth认证。
认证成功后，AI代理（如Claude）就可以通过MCP客户端调用本服务器暴露的工具来访问和操作您的Google Workspace数据。例如，AI可以请求“列出我的Google Drive文件夹”、“在某个表格中添加一行数据”或“获取一个Google文档的内容”。
如需更详细的使用指导，请参阅官方用户指南：Google Workspace MCP User Guide。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (针对MCP客户端)

基本使用方法

信息