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）進行通信。