Ai Scheduler MCP

🚀 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）を設定することをおすすめします。

# 例えば、シェルの設定ファイルに以下を追加します。
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）を使用して通信します。