Zoom MCP

🚀 Zoom MCP サーバー

このプロジェクトは、Zoomに対応したモデルコンテキストプロトコル（MCP）サーバーを実装しています。これにより、AIモデルがZoomのAPI機能を通じてアクセスできるようになります。

🚀 クイックスタート

このプロジェクトでは、MCPサーバーを実装してClaudeをZoomに接続し、データを取得し、Zoom APIを介して操作を実行できるようにしています。ClaudeとZoomの間の橋渡し役として機能し、Zoomの会議、ユーザー、録音にアクセスできます。

✨ 主な機能

• Server-to-Server OAuth 2.0認証を使用してZoomに接続
• ユーザー情報とプロファイルを取得
• 会議詳細と録音にアクセス
• Zoomアカウントの設定と構成を照会
• Zoomリソースを管理する標準API
• API接続のトラブルシューティング用のデバッグモード

📦 インストール

前提条件

• Python 3.11以上
• 管理権限を持つZoomアカウント
• 適切なスコープを持つZoomサーバー間OAuthアプリケーション
• uvをPythonパッケージ管理に使用

セットアップ

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/zoom-mcp.git
   cd zoom-mcp
   

2. 仮想環境を作成し、uvを使用してアクティブ化します：

   uv venv
   source .venv/bin/activate  # Windowsユーザーは：.venv\Scripts\activate を使用
   

3. uvを使用して依存関係をインストールします：

   uv pip install -e .
   

4. Zoom APIの認証情報を設定します：

   python scripts/setup_zoom_auth.py
   

   このスクリプトは、.envファイルにZoom APIの認証情報を設定する手順を案内します：

   ZOOM_API_KEY=your-client-id
   ZOOM_API_SECRET=your-client-secret
   ZOOM_ACCOUNT_ID=your-account-id
   

💻 使用例

接続テスト

認証情報を設定した後、Zoom APIとの接続をテストできます：

python scripts/test_zoom_connection.py

このスクリプトは以下を検証します：

• 環境変数が正しく設定されているか
• OAuthトークンの生成が正常に機能するか
• 基本的なAPIアクセスが成功するか

APIエンドポイント

MCPサーバーは、様々なZoom APIエンドポイントへのアクセスを提供します：

• /users/me - 認証されたユーザーに関する詳細情報を取得
• 必要に応じて他のエンドポイントを実装

🔧 技術詳細

認証

このプロジェクトは、ZoomのServer-to-Server OAuth 2.0認証を使用しています。認証モジュールは以下を処理します：

• OAuth 2.0トークンの生成
• トークンのキャッシュと更新
• 環境変数の構成

認証フロー：

1. APIキーとシークレットをBase64エンコードして基本認証に使用
2. ZoomのOAuthエンドポイントにアクセストークンを要求
3. トークンを使用して後続のAPIリクエストを行う
4. トークンが期限切れになったときに自動的に更新

開発

Zoomアプリケーションの作成

1. Zoom App Marketplaceにアクセスしてログインします。
2. 右上の「Develop」をクリックし、メニューから「構築」を選択します。
3. アプリの詳細情報で、アプリ名、説明、同意URLを入力します。
4. 「高度な設定」に移動し、OAuth 2.0認証を有効にし、ユーザー承認用のコールバックURLを設定します。
5. 変更を保存し、API接続用のクライアントIDとシークレットを取得します。

アクセス権限

アプリケーションを作成した後、Zoom APIとやり取りするために必要な権限を付与する必要があります。以下は一般的な権限です：

• zoom_basic - 基本アクセス（会議、ユーザー情報の読み取りなど）
• zoom_video - ビデオ会議の制御
• zoom_audit_logs - 監査ログのアクセス
• APIの要件に応じて他の権限を選択

構成例

プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加してZoom APIを構成します：

ZOOM_CLIENT_ID=your-client-id
ZOOM_CLIENT_SECRET=your-client-secret
ZOOM_API_KEY=your-api-key
ZOOM_API_SECRET=your-api-secret

トラブルシューティング

Zoom APIに接続できない場合

• APIキーとシークレットが正しく構成されていることを確認します。
• アプリケーションの権限が有効になっていることを確認します。
• Zoomのドキュメントを参照して、APIエンドポイントとパラメータが正しいことを確認します。

認証に失敗した場合

• OAuthトークンが有効であることを検証します。
• コールバックURLがZoomアプリで正しく設定されていることを確認します。
• リクエストヘッダーのAuthorizationフィールドが正しくフォーマットされていることを確認します。

📄 ライセンス

このプロジェクトはMIT Licenseの下で保護されています。