ai-scheduler-mcp

整合 Google Tasks 和 Calendar API 的 MCP（模型上下文协议）服务器。允许从 MCP 客户端（如 Roo Code 等）使用 Google Tasks 和 Calendar 功能。

前提条件

• 已安装 Docker。
• 存在名为 mcp-network 的 Docker 网络。

  # 如果不存在，执行以下命令创建：
  docker network create mcp-network
  

设置准备

1. 仓库准备: 克隆或下载此仓库。

2. 认证信息 (credentials.json) 准备:

   • 在 Google Cloud Console 中创建 OAuth 2.0 客户端 ID（“桌面应用”或“网络应用”类型），并启用 Google Tasks API 和 Google Calendar API。
   • 下载生成的认证信息，并以 credentials.json 为文件名保存在项目根目录 (ai-scheduler-mcp/) 中。
   • 注意: credentials.json 是机密信息。绝不要提交到 Git 仓库。 （已包含在 .gitignore 中）

3. Docker 镜像构建: 使用 scripts/ai-scheduler-mcp.sh 脚本来管理项目。为了方便使用，建议设置别名（如 ai-scheduler-mcp）。

   # 例如，在 shell 配置文件中添加：
   alias ai-scheduler-mcp="/path/to/your/project/ai-scheduler-mcp/scripts/ai-scheduler-mcp.sh"
   

   然后使用环境变量指定端口（默认为 3003）。

   export PORT=${PORT:-3003}
   

使用说明

• 进入项目根目录并运行脚本:

  cd /path/to/your/project/ai-scheduler-mcp
  ./scripts/ai-scheduler-mcp.sh
  

命令操作

# 构建镜像，默认端口为3003，可指定 --port 参数修改：
ai_scheduler_mcp build [--port ${PORT}]

# 启动容器，默认使用 credentials.json 和环境变量配置：
ai_scheduler_mcp up [--build] [--env-file .env]

# 停止容器：
ai_scheduler_mcp down

# 重新启动容器：
ai_scheduler_mcp restart

其他信息

• 直接使用 Docker: 可以直接使用 docker build 和 docker run 命令，具体操作请参考 scripts/ai-scheduler-mcp.sh 内容或 Docker 文档。
• 容器间连接: 同一 mcp-network 网络中的其他容器可通过 http://ai-scheduler-mcp-server:${PORT}/sse 进行连接。
• 通信协议: 本服务器使用 SSE（Server-Sent Events）进行通信。

把以上内容完整地翻译成中文，只返回翻译后的内容，不要有任何其他无关的信息。