ai-scheduler-mcp

🚀 AI调度器MCP

这是一个整合了 Google Tasks 和 Calendar API 的 MCP（模型上下文协议）服务器。它允许 MCP 客户端（例如 Roo Code 等）使用 Google Tasks 和 Calendar 的相关功能。

🚀 快速开始

✨ 主要特性

• 整合 Google Tasks 和 Calendar API，为 MCP 客户端提供相关功能支持。

📦 安装指南

前提条件

• 已安装 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）进行通信。