Zoom 录音转录 MCP 服务器

一个用于与 Zoom 云录制转录交互的 MCP (模型上下文协议) 服务器。 此服务器允许您通过结构化的界面列出、下载、搜索和管理您的 Zoom 会议转录。

<a href="https://glama.ai/mcp/servers/b01uqjtp7w"> <img width="380" height="200" src="https://glama.ai/mcp/servers/b01uqjtp7w/badge" alt="Zoom Transcript Server MCP server" /> </a>

功能

• 列出会议: 查看所有可用的带有录音的 Zoom 会议
• 下载转录: 通过 ID 或 UUID 从特定会议下载转录
• 获取最近的转录: 自动下载最近会议的转录
• 搜索转录: 搜索所有已下载的转录中的特定内容
• 有组织的存储: 转录按月份存储在结构化的文件系统中

前提条件

• Node.js (v16 或更高版本)
• 启用了云录制的 Zoom 帐户
• Zoom OAuth 应用程序凭据 (帐户 ID, 客户端 ID, 客户端密钥)

安装

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  # 可选，默认为 ./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"  // 可选
      }
    }
  }
}

获取 Zoom 凭据

1. 前往 Zoom 应用市场 并登录
2. 点击 "开发" > "构建应用"
3. 选择 "服务器到服务器 OAuth" 应用类型
4. 填写所需信息
5. 在 "权限范围" 下，添加以下权限:
   • cloud_recording:read:list_account_recordings:admin
   • cloud_recording:read:recording:admin
   • cloud_recording:read:list_user_recordings:admin
6. 保存并激活您的应用
7. 记下您的帐户 ID, 客户端 ID 和客户端密钥

用法

可用工具

1. list_meetings

列出可用的带有录音的 Zoom 会议。

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

2. download_transcript

下载特定会议的转录。

{
  "meetingId": "123456789"  // 会议 ID 或 UUID
}

3. get_recent_transcripts

下载最近会议的转录。

{
  "count": 5  // 要获取的最近会议的数量 (默认: 5)
}

4. search_transcripts

搜索已下载的转录中的特定内容。

{
  "query": "AI discussion",
  "dateRange": {  // 可选
    "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