Zoom MCP Server

Zoom MCP サーバー

Zoom 向けの Model Context Protocol（MCP）サーバー実装です。AI モデルが Zoom の API 機能を利用できるようにします。

概要

このプロジェクトは、Claude が Zoom に接続し、Zoom API を通じてデータを取得したり、操作を実行したりできる MCP サーバーを実装します。Claude と Zoom の間の橋渡しとして機能し、Zoom のミーティング、ユーザー、録画にシームレスに統合してアクセスできるようにします。

機能

• Server-to-Server OAuth 2.0 認証を使用して Zoom に接続
• ユーザー情報とプロフィールを取得
• ミーティングの詳細と録画にアクセス
• Zoom アカウントの設定と構成を照会
• 標準化された API を通じて Zoom リソースを管理
• API 接続のトラブルシューティングに役立つデバッグモード

インストール

前提条件

• Python 3.11 以降
• 管理者権限を持つ Zoom アカウント
• 適切なスコープを設定した Zoom Server-to-Server OAuth アプリ
• Python パッケージ管理用の uv

セットアップ

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

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

2. uv を使用して仮想環境を作成し、有効化します：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

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

   uv pip install -e .
   

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

   python scripts/setup_zoom_auth.py
   

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

   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 Key と Secret を Base64 エンコードして Basic 認証に使用します
2. Zoom の OAuth エンドポイントにアクセストークンをリクエストします
3. 以降の API リクエストにトークンを使用します
4. トークンの有効期限が切れたら自動的に更新します

開発

Zoom アプリの作成

1. Zoom App Marketplace にアクセスしてサインインします
2. 右上の「Develop」をクリックし、「Build App」を選択します
3. アプリの種類として「Server-to-Server OAuth」を選択します
4. アプリに必要な情報を入力します
5. 「Scopes」セクションで、次のスコープを追加します：
   • user:read:admin（基本的なユーザー情報の取得に必要）
   • 特定のユースケースに応じて必要な追加スコープ

テストの実行

python -m pytest

コードスタイル

このプロジェクトでは PEP 8 ガイドラインに準拠しています。次のコマンドでコードスタイルを確認できます：

uv pip install flake8
flake8 src tests

トラブルシューティング

Zoom API への接続で問題が発生した場合：

1. 認証エラー

   • API Key と Secret が正しいことを確認します
   • アプリで必要なスコープが有効になっていることを確認します
   • Zoom Marketplace でアプリを無効化してから、再度有効化します

2. 権限エラー

   • アカウントに必要な権限があることを確認します
   • リクエストしたスコープが、アクセスしようとしているエンドポイントに合っていることを確認します

3. Account ID の問題

   • Zoom アカウントのプロフィールに記載されている正しい Account ID を使用していることを確認します
   • Server-to-Server OAuth アプリでは Account ID が必要です

貢献

皆様からの貢献を歓迎します！お気軽に Pull Request を送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。