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
- 安装依赖项:
- 构建项目:
配置
在根目录中创建一个.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 凭证
- 前往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" // Optional
}
2. 下载成绩单
下载特定会议的记录。
{
"meetingId": "123456789" // Meeting ID or UUID
}
3. 获取最近的成绩单
下载最近会议的记录。
{
"count": 5 // Number of recent meetings to fetch (default: 5)
}
4. 搜索成绩单
在下载的记录中搜索特定内容。
{
"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
建筑
本地运行
执照
麻省理工学院