Zoom Transcript MCP Server

Zoom Transcript MCP 服务

一个用于与 Zoom 云录制转录文本交互的 MCP（Model Context Protocol）服务。此服务允许你通过结构化界面列出、下载、搜索和管理 Zoom 会议转录文本。

功能

• 列出会议：查看所有包含录制内容的 Zoom 会议
• 下载转录文本：通过 ID 或 UUID 下载指定会议的转录文本
• 获取最近的转录文本：自动下载最近会议的转录文本
• 搜索转录文本：在所有已下载的转录文本中搜索指定内容
• 有序存储：转录文本按月份存储在结构化文件系统中

先决条件

• Node.js（v16 或更高版本）
• 已启用云录制的 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 应用市场 并登录
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