MCPApp

MCPApp

site icon
2025.05.08 0
JavaScriptAI 集成Google Workspace 自动化开发效率交流协作
MCPApp 是一个基于 Google Apps Script (GAS) 实现的 Model Context Protocol (MCP) 服务器,旨在作为 AI 应用与外部系统(如 Google Workspace 服务)之间的通用适配器。它通过标准化协议使 AI 能够安全访问和利用 Google Drive、Google Calendar 等数据,从而支持 AI 增强的工作流程。
View on GitHub

Overview

基本能力

产品定位

MCPApp 是一个中间件,用于连接 AI 应用与 Google Workspace 服务,实现数据的安全访问和功能调用。

核心功能

  1. 标准化协议支持:实现 MCP 协议,支持与 AI 客户端的交互。
  2. Google Workspace 集成:提供对 Google Drive 和 Google Calendar 的访问能力。
  3. 工具和资源管理:支持工具调用(如文件搜索、日程查询)和资源读取(如日程信息)。
  4. 日志记录:可选功能,记录客户端与服务器之间的交互日志。

适用场景

  1. AI 增强的工作流程:通过 AI 客户端调用 Google Workspace 数据,实现自动化任务。
  2. 内部工具开发:为企业内部开发定制化的 AI 工具,提升工作效率。
  3. 教育和研究:用于教学或研究项目中,展示 AI 与外部系统的集成能力。

工具列表

  1. search_files_on_Google_Drive:在指定文件夹中搜索文件。
  2. search_schedule_on_Google_Calendar:查询指定日期的日程安排。
  3. get_today_schedule:获取当天的日程信息。

常见问题解答

  1. 协议版本不匹配:客户端和服务器的协议版本需一致,否则可能导致无响应。
  2. 内容类型限制:某些客户端可能不支持特定类型的内容返回(如数组类型)。

使用教程

使用依赖

  1. Google 账号:用于创建和部署 Google Apps Script 项目。
  2. Claude Desktop 或 Copilot for Visual Studio Code:用于测试 MCP 服务器。

安装教程

  1. 创建 Google Apps Script 项目
  2. 访问 Google Apps Script 创建独立类型项目。
  3. 安装库
  4. 在脚本编辑器中,选择“资源” > “库”,输入库的项目键:1TlX_L9COAriBlAYvrMLiRFQ5WVf1n0jChB6zHamq2TNwuSbVlI5sBUzh
  5. 部署为 Web App
  6. 在脚本编辑器中,点击“部署” > “新建部署” > “Web App”。
  7. 设置执行身份为“我”,访问权限为“任何人”。
  8. 复制生成的 Web App URL。

调试方式

  1. 测试工具调用
  2. 使用 Claude Desktop 或 Copilot 配置 MCP 服务器 URL 进行测试。
  3. 查看日志
  4. 在脚本中启用日志功能,将日志记录到指定的 Google Sheets 中。

```

许可证

该项目遵循 MIT 开源许可条款。