Gws MCP Server

gws-mcp服务器

](https://www.npmjs.com/package/gws-mcp-server) 

为什么？

这 gws CLI有一个内置的MCP服务器 在v0.8.0中删除 因为它暴露了200-400个工具，导致MCP客户端的上下文窗口膨胀。该服务器采用了一种精心策划的方法：您可以选择公开哪些谷歌服务，只有一组集中的高价值、范围狭窄的操作被注册为工具。

先决条件

• 18+
• gws 命令行界面 已安装并验证(npm install -g @googleworkspace/cli && gws auth login)

快速开始

# Install
npm install -g gws-mcp-server

# Or run from source
git clone https://github.com/conorbronsdon/gws-mcp-server.git
cd gws-mcp-server
npm install && npm run build

配置

克劳德代码(.mcp.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar,docs,gmail"
      ]
    }
  }
}

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar"
      ]
    }
  }
}

选项

可用的服务和工具

drive （8工具）

• drive_files_list --搜索和列出文件
• drive_files_get --获取文件元数据
• drive_files_create --创建文件（可选择上传）
• drive_files_copy --复制文件（可用于格式转换）
• drive_files_update --更新文件元数据/内容
• drive_files_delete --删除文件
• drive_files_export --将Google Workspace文件（文档、工作表、幻灯片）导出为其他格式
• drive_permissions_create --共享文件

sheets （4个工具）

• sheets_get --获取电子表格元数据
• sheets_values_get --读取单元格值
• sheets_values_update --写入单元格值
• sheets_values_append --添加行

calendar （5个工具）

• calendar_events_list --列出事件
• calendar_events_get --获取活动详细信息
• calendar_events_insert --创建事件
• calendar_events_update --更新事件
• calendar_events_delete --删除事件

docs （3个工具）

• docs_get --获取文档内容
• docs_create --创建文档
• docs_batchUpdate --应用文档更新

gmail （4个工具）

• gmail_messages_list --搜索邮件
• gmail_messages_get --阅读消息
• gmail_threads_list --搜索线索
• gmail_threads_get --阅读完整帖子

总计：24个工具 （与旧实施中的200-400相比）

添加新工具

编辑 src/services.ts 添加工具定义。每个工具都直接映射到 gws CLI命令：

{
  name: "drive_files_list",           // MCP tool name
  description: "List files in Drive", // Shown to AI
  command: ["drive", "files", "list"],// gws CLI args
  params: [                           // Maps to --params JSON
    { name: "q", description: "Search query", type: "string", required: false },
  ],
  bodyParams: [                       // Maps to --json body
    { name: "name", description: "File name", type: "string", required: true },
  ],
}

建筑

MCP Client (Claude) ←→ stdio ←→ gws-mcp-server ←→ gws CLI ←→ Google APIs

服务器是一个精简的包装器：它将MCP工具调用转换为 gws CLI调用、传递 --params 和 --json 并返回JSON输出。

______________________________________________________________________

免责声明

*就此发表的所有观点、意见和声明都是我自己的，是以个人身份作出的。它们不反映，也不应被解释为反映Modular的观点、立场或政策。此帐户与Modular没有任何关联、授权或背书。*

许可证

麻省理工学院