calcom-mcp

Cal.com FastMCP サーバー

⚠️免責事項：このプロジェクトはCal.comと提携しておらず、Cal.comの承認も受けていません。私は独立した開発者であり、Cal.comと公式な関係は一切ありません。

このプロジェクトは、Cal.com APIと連携するためのFastMCPサーバーを提供します。これにより、言語学習モデル（LLM）は、イベントの種類や予約の管理といった重要なCal.com機能に接続するためのツールを利用できるようになります。

前提条件

• Python 3.8以上
• Cal.comアカウントとAPIキー（v2）

設定

1. リポジトリをクローンするか（該当する場合）、ファイルをダウンロードします。
   git clone https://github.com/Danielpeter-99/calcom-mcp.git cd calcom-mcp
2. 仮想環境を作成します (推奨):
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. 依存関係をインストールします:
   pip install -r requirements.txt
4. Cal.com APIキーの設定： CALCOM_API_KEY環境変数を設定する必要があります。APIキーはCal.comの設定ページ（通常は開発者向けまたはセキュリティ設定）から取得できます。
   • Linux/macOS:
     export CALCOM_API_KEY="your_actual_api_key_here"
     永続的にするには、この行をシェル構成ファイル (例: .bashrc 、 .zshrc ) に追加します。
   • Windows (PowerShell):
     $env:CALCOM_API_KEY="your_actual_api_key_here"
     永続的にするには、「システム プロパティ」>「環境変数」で設定します。

サーバーの実行

セットアップが完了したら、FastMCP サーバーを実行できます。

サーバーはlocalhost:8010で起動し、実行中であることを示す出力が表示されます。CALCOM_API_KEY CALCOM_API_KEY設定されていない場合は、警告が表示されます。

利用可能なツール

現在、サーバーは LLM 対話用の次のツールを提供しています。

• get_api_status() : Cal.com APIキーが環境に設定されているかどうかを確認します。ステータスを示す文字列を返します。
• list_event_types() : 認証済みアカウントのCal.comからすべてのイベントタイプのリストを取得します。イベントタイプのリストを含む辞書、またはエラーメッセージを返します。
• get_bookings(...) : Cal.comから予約リストを取得します。オプションのフィルター（event_type_id、user_id、status、date_from、date_to、limit）を使用します。予約リストを含む辞書、またはエラーメッセージを返します。
• create_booking(...) : Cal.com で、特定のイベントタイプと参加者を指定して新しい予約を作成します。開始時刻、参加者の詳細、イベントタイプの識別子などのパラメータが必要です。予約の詳細を含む辞書、またはエラーメッセージを返します。
• list_schedules(...) : 認証済みユーザーまたは特定のユーザー／チームで利用可能なすべてのスケジュールを一覧表示します。オプションのフィルター：user_id、team_id、limit。スケジュールのリストを含む辞書、またはエラーメッセージを返します。
• list_teams(...) : 認証されたユーザーが利用できるすべてのチームを一覧表示します。オプションのフィルター: limit。チームのリストを含む辞書、またはエラーメッセージを返します。
• list_users(...) : 認証済みアカウントで利用可能なすべてのユーザーを一覧表示します。オプションのフィルター: limit。ユーザーのリストを含む辞書、またはエラーメッセージを返します。
• list_webhooks(...) : 認証済みアカウントに設定されているすべてのWebhookを一覧表示します。オプションのフィルター: limit。Webhookのリストを含む辞書、またはエラーメッセージを返します。

**注:**すべてのツールはCALCOM_API_KEY環境変数を設定する必要があります。設定されていない場合、ツールは構造化されたエラーメッセージを返します。

ツールの使用とエラー処理

• すべてのツールは、API 応答 (辞書または文字列として) または失敗の詳細を含む構造化されたエラー メッセージを返します。
• エラー メッセージには、エラーの種類、HTTP ステータス コード (該当する場合)、Cal.com API からの応答テキストが含まれます。
• 最良の結果を得るには、返されたデータを使用する前に、応答にerrorキーが存在するかどうかを常に確認してください。
• ツールは堅牢に設計されており、成功した API 呼び出しと失敗した API 呼び出しの両方について有益なフィードバックを提供します。

開発ノート

• Cal.com API ベース URL はhttps://api.cal.com/v2に設定されています。
• 認証は主に、 CALCOM_API_KEYを使用したベアラー トークンを使用して処理されます。
• create_bookingツールは、そのエンドポイントの Cal.com API v2 ドキュメントで指定されているcal-api-version: 2024-08-13ヘッダーを使用します。
• 有益な応答を提供するために、API 呼び出しにはエラー処理が含まれています。

🚀 で構築

重要なセキュリティに関する注意事項

CALCOM_API_KEYソースコードに直接ハードコードしないでください。APIキーのセキュリティを確保するため、必ずセットアップ手順に記載されている環境変数を使用してください。