Zoom转录MCP服务器

Name: Zoom转录MCP服务器
Author: forayconsulting

作者：forayconsulting7 星标更新：2025-03-14

安装使用来源：spider==github.com

项目介绍

Zoom 录制会议转录 MCP 服务器

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

功能

列出会议：查看所有带有录制内容的 Zoom 会议
下载转录：根据会议 ID 或 UUID 下载特定会议的转录
获取最近转录：自动下载最近会议的转录
搜索转录：在所有已下载的转录中搜索特定内容
有序存储：按月存储转录到结构化的文件系统

预备条件

Node.js (v16 或更高版本)
启用了云录制功能的 Zoom 账户
Zoom OAuth 应用凭证（账户 ID、客户端 ID、客户端密钥）

安装

克隆此仓库：

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

安装依赖项：
```
npm install
```
构建项目：
```
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 凭证

登录至 Zoom 应用市场
点击“开发” > “构建应用”
选择“服务器到服务器 OAuth”应用类型
填写所需信息
在“范围”下添加以下权限：
- cloud_recording:read:list_account_recordings:admin
- cloud_recording:read:recording:admin
- cloud_recording:read:list_user_recordings:admin
保存并激活您的应用
记录您的账户 ID、客户端 ID 和客户端密钥

使用方法

可用工具

1. 列出会议

列出带有录制内容的 Zoom 会议。

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

2. 下载转录

下载特定会议的转录。

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

3. 获取最近转录

下载最近会议的转录。

{
  "count": 5  // 要获取的最近会议数量（默认：5）
}

4. 搜索转录

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

{
  "query": "AI 讨论",
  "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": "项目时间线"
}
</arguments>
</use_mcp_tool>

转录存储

转录按照以下结构存储：

transcripts/
├── YYYY-MM/
│   ├── YYYY-MM-DD_HH-MM-SS_会议主题_会议ID.vtt
│   └── metadata/
│       └── YYYY-MM-DD_HH-MM-SS_会议主题_会议ID.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