AI导哈

Google Workspace MCP 服务器

一个实现模型上下文协议（MCP）的服务器，为AI模型提供对Google Workspace工具（Gmail、日历、Drive和Docs）的安全实时访问。

  • by tconn93
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 tconn93/mcp-google-workspace

使用说明

谷歌工作区MCP服务器

实施 模型上下文协议（MCP） 服务器，为人工智能模型提供对谷歌工作区工具（Gmail、日历、云端硬盘和文档）的安全、实时访问。

🚀 特性

  • 📧 Gmail集成： 搜索帖子、阅读消息和起草回复。
  • 📅 日历管理： 检查可用性、列出活动并安排新会议。
  • 📂 驱动器和文件： 搜索文件、导出内容和创建新文档。
  • 🛡️ 安全OAuth2： 内置Google Cloud身份验证处理。
  • ✅ 类型安全： 使用官方的MCP SDK和Zod进行模式验证，在TypeScript中完全实现。

🛠 先决条件

  • Node.js： v18.x或更高版本
  • 谷歌云项目： 启用了工作区API的活动项目。
  • OAuth2凭据： A. credentials.json 从您的Google Cloud控制台下载文件。

📦 安装

  1. 克隆存储库：
git clone https://github.com/your-username/google-workspace-mcp.git
cd google-workspace-mcp
  1. 安装依赖项：
npm install
  1. 配置环境变量： 创建一个 .env 根目录中的文件：
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback
  1. 构建项目：
npm run build

🔌 LLM客户端的配置

将其与客户端一起使用，例如 克劳德桌面 或 光标，将以下内容添加到您的配置文件中（例如。， claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/your/repo/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "...",
        "GOOGLE_REDIRECT_URI": "..."
      }
    }
  }
}

🛠 可用工具

工具 说明 输入参数
list_gmail_messages 检索最近的电子邮件列表。 maxResults （数字）， q （搜索查询）
get_calendar_events 从特定日历中获取即将发生的事件。 calendarId （字符串）， timeMin （ISO日期）
search_drive 在Google云端硬盘中搜索文件和文件夹。 query （字符串）
create_doc 使用指定内容创建新的Google文档。 title （字符串）， content （字符串）

🤝 贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

📄 许可证

麻省理工学院

相关 MCP