使用说明

项目简介

Google Kit 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在让AI模型能够安全、便捷地访问和操作您的Google服务，如日历、Gmail和Google Chat。通过 Google Kit，AI模型可以调用预设的工具，例如创建日历事件、搜索邮件、发送聊天消息等，从而扩展AI模型的功能边界，提升应用智能化水平。

主要功能点

日历工具 (Calendar)：
- 创建、查询、更新和回复 Google 日历事件，帮助AI模型管理日程。
Gmail 工具 (Gmail)：
- 搜索邮件、移动邮件到垃圾箱、创建和管理邮件过滤器和标签，辅助AI模型处理电子邮件。
Google Chat 工具 (Gchat)：
- 列出聊天空间、发送消息、查询用户信息和消息列表，使AI模型能够在Google Chat中进行交互。
工具分组启用：
- 可以根据需要启用或禁用特定工具组（日历、Gmail、Gchat），灵活定制AI模型的能力。

安装步骤

安装 Go 环境：确保您的系统已安装 Go 1.23.2 或更高版本。

安装 Google Kit：打开终端，运行以下命令安装 Google Kit 服务器：

go install github.com/nguyenvanduocit/google-kit@latest

配置环境变量：

在本地创建 '.env' 文件，并根据需要配置以下环境变量：

GOOGLE_CREDENTIALS_FILE=  # 必需：Google Cloud 凭据 JSON 文件路径
GOOGLE_TOKEN_FILE=       # 必需：存储 Google OAuth 令牌的文件路径
ENABLE_TOOLS=           # 可选：逗号分隔的工具组列表，用于启用特定工具 (留空则启用所有工具)
PROXY_URL=             # 可选：HTTP/HTTPS 代理 URL (如果需要)

获取 Google Cloud 凭据：
- 访问 Google Cloud Platform Console，创建一个项目或选择现有项目。
- 启用以下 Google API：
  - Google Calendar API
  - Gmail API
  - Google Chat API
- 创建 OAuth 2.0 客户端 ID 凭据，下载凭据 JSON 文件，并将其路径配置到 'GOOGLE_CREDENTIALS_FILE' 环境变量中。
获取 Google OAuth 令牌：
- 运行仓库 scripts 目录下的 'get-google-token' 脚本，根据提示完成 OAuth 授权流程，脚本会将生成的令牌保存到 'GOOGLE_TOKEN_FILE' 环境变量配置的文件路径中。

服务器配置

要将 Google Kit 配置为 MCP 服务器供客户端（例如 Claude）使用，请在客户端的配置文件中添加以下 server 配置信息。例如，在 Claude 的 'config.json' 文件中，'mcpServers' 部分添加：

{
  "mcpServers": {
    "google_kit": {
      "command": "google-kit",
      "args": ["-env", "/path/to/.env"]
    }
  }
}

'server name': 'google_kit' (服务器名称，客户端配置中用于引用)
'command': 'google-kit' (服务器启动命令，确保 google-kit 可执行文件在您的 PATH 环境变量中，或者使用可执行文件的完整路径)
'args': '["-env", "/path/to/.env"]' (传递给服务器的启动参数，'-env' 参数指定 '.env' 文件的路径，请替换为实际的 '.env' 文件路径)

基本使用方法

确保已完成安装步骤和服务器配置。
启动 MCP 客户端（例如 Claude），客户端将根据配置连接到 Google Kit MCP 服务器。
在 MCP 客户端中，可以使用自然语言指令调用 Google Kit 提供的工具，例如：
- "创建一个明天上午 9 点到 10 点的会议，主题是项目讨论，参与者是 [email protected]" (调用 'calendar_create_event' 工具)
- "搜索最近一周我收到的包含 '紧急' 关键词的邮件" (调用 'gmail_search' 工具)
- "在 Google Chat 的 '项目群' 空间发送消息 '最新的进展报告已经上传'" (调用 'gchat_send_message' 工具)
AI模型将根据您的指令，自动调用相应的 Google Kit 工具，并返回执行结果。

请注意，Google Kit 服务器需要在具有 Google Cloud 凭据和 OAuth 令牌的环境中运行，并确保已启用所需 Google API。

关键词