Zoom Transcript MCP Server

Zoom Transcript MCP Server

Zoom Cloud Recording のトランスクリプトを操作するための MCP（Model Context Protocol）サーバーです。このサーバーでは、構造化されたインターフェースを通じて、Zoom ミーティングのトランスクリプトの一覧表示、ダウンロード、検索、管理を行えます。

機能

• ミーティングの一覧表示：録画がある、利用可能なすべての Zoom ミーティングを表示します
• トランスクリプトのダウンロード：ID または UUID を指定して、特定のミーティングのトランスクリプトをダウンロードします
• 最近のトランスクリプトの取得：最近のミーティングのトランスクリプトを自動的にダウンロードします
• トランスクリプトの検索：ダウンロード済みのすべてのトランスクリプトから、特定の内容を検索します
• 整理された保存：トランスクリプトは月ごとに整理されたファイルシステムに保存されます

前提条件

• Node.js（v16 以降）
• Cloud Recording が有効な Zoom アカウント
• Zoom OAuth アプリの認証情報（Account ID、Client ID、Client Secret）

インストール

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

   git clone https://github.com/yourusername/zoom_transcript_mcp.git
   cd zoom_transcript_mcp
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

設定

ルートディレクトリに .env ファイルを作成し、次の変数を設定します：

ZOOM_ACCOUNT_ID=your_zoom_account_id
ZOOM_CLIENT_ID=your_zoom_client_id
ZOOM_CLIENT_SECRET=your_zoom_client_secret
TRANSCRIPTS_DIR=/path/to/transcripts/directory  # Optional, defaults to ./transcripts

または、MCP 設定ファイルを使ってサーバーを設定できます：

{
  "mcpServers": {
    "zoom-transcripts": {
      "command": "node",
      "args": ["/path/to/zoom-transcripts-server/build/index.js"],
      "env": {
        "ZOOM_ACCOUNT_ID": "your_zoom_account_id",
        "ZOOM_CLIENT_ID": "your_zoom_client_id",
        "ZOOM_CLIENT_SECRET": "your_zoom_client_secret",
        "TRANSCRIPTS_DIR": "/path/to/transcripts/directory"  // Optional
      }
    }
  }
}

Zoom 認証情報の取得

1. Zoom App Marketplace にアクセスしてサインインします
2. 「Develop」>「Build App」をクリックします
3. アプリの種類として「Server-to-Server OAuth」を選択します
4. 必要な情報を入力します
5. 「Scopes」で、次の権限を追加します：
   • cloud_recording:read:list_account_recordings:admin
   • cloud_recording:read:recording:admin
   • cloud_recording:read:list_user_recordings:admin
6. アプリを保存して有効化します
7. Account ID、Client ID、Client Secret を控えます

使い方

利用可能なツール

1. list_meetings

録画がある、利用可能な Zoom ミーティングを一覧表示します。

{
  "dateRange": {
    "from": "2025-01-01",
    "to": "2025-03-31"
  },
  "participant": "John Doe"  // Optional
}

2. download_transcript

特定のミーティングのトランスクリプトをダウンロードします。

{
  "meetingId": "123456789"  // Meeting ID or UUID
}

3. get_recent_transcripts

最近のミーティングのトランスクリプトをダウンロードします。

{
  "count": 5  // Number of recent meetings to fetch (default: 5)
}

4. search_transcripts

ダウンロード済みのトランスクリプトから、特定の内容を検索します。

{
  "query": "AI discussion",
  "dateRange": {  // Optional
    "from": "2025-01-01",
    "to": "2025-03-31"
  }
}

Claude での使用例

<use_mcp_tool>
<server_name>zoom-transcripts</server_name>
<tool_name>search_transcripts</tool_name>
<arguments>
{
  "query": "project timeline"
}
</arguments>
</use_mcp_tool>

トランスクリプトの保存

トランスクリプトは次の構成で保存されます：

transcripts/
├── YYYY-MM/
│   ├── YYYY-MM-DD_HH-MM-SS_Meeting-Topic_MeetingID.vtt
│   └── metadata/
│       └── YYYY-MM-DD_HH-MM-SS_Meeting-Topic_MeetingID.json

各トランスクリプトには、次の情報を含む対応するメタデータ JSON ファイルがあります：

• ミーティング ID と UUID
• トピック
• 開始時刻と所要時間
• 参加者（トランスクリプトから抽出）
• トランスクリプトのファイルパス

開発

プロジェクト構成

zoom_transcript_mcp/
├── src/
│   └── index.ts
├── package.json
├── tsconfig.json
├── .gitignore
├── README.md
└── .env.example

ビルド

npm run build

ローカルでの実行

node build/index.js

ライセンス

MIT