Zoom会议记录搜索工具

ECHO是一款用于搜索和管理Zoom会议转录文本的服务,支持通过MCP兼容的AI工具进行搜索和总结。

  • by Percona-Lab
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Percona-Lab/ECHO

使用说明

ECHO-探索电话、听证会和观察

✅ 重新开始开发(2026年6月)

ECHO现在支持Zoom AI伴侣通话记录。 Zoom为AI Companion会议摘要公开了用户级OAuth范围(meeting:read:summary),因此,即使云记录未处于活动状态,ECHO也可以检索会议摘要。通过会议所有权进行访问:您可以检索您的帐户(您是主持人)拥有的会议笔记。纯粹的与会者什么也得不到;共同主持或共享给您的会议未经测试,可能受到Zoom的限制。

推出正在等待两个用户管理的作用域(meeting:read:summary, meeting:read:list_meetings)被添加到组织的Zoom OAuth应用程序中,之后每个用户都会重新运行 echo-login 一次。

MCP服务器,用于从任何兼容MCP的AI工具中搜索Zoom会议记录。部分 Alpine工具包.

使用OAuth 2.0+PKCE,因此任何秘密都不会触及您的计算机。您使用自己的Zoom帐户登录,ECHO只能看到您的录音。

安装

curl -fsSL https://raw.githubusercontent.com/Percona-Lab/ECHO/main/install.sh | bash

安装程序将引导您完成以下操作:

  1. 克隆ECHO并通过uv安装其Python deps
  2. 在公共注册表中查找您的组织(对于Percona,没有其他问题,只需输入 percona)
  3. 在Claude Desktop、Claude Code或您拥有的任何MCP客户端上注册ECHO
  4. Zoom OAuth一次性登录

安装后,您的AI工具会自动获取这些斜线命令: /echo_status, /echo_recent, /echo_search <query>, /echo_summary <id>, /echo_transcript <id>, /echo_notes <meeting>.

安装程序将指导您完成以下操作:

  1. 克隆仓库并安装依赖项
  2. 配置Zoom OAuth客户端ID(或使用注册表)
  3. 使用您的Zoom帐户进行身份验证
  4. 自动检测和配置您的AI客户端

先决条件

你需要一个 缩放OAuth客户端ID 来自通用应用程序(OAuth 2.0)。如果您有Zoom帐户的管理员或所有者访问权限,则可以自己创建。如果没有,请咨询您的Zoom管理员。

创建Zoom OAuth应用程序

  1. 首选 marketplace.zoom.us > 开发 > 构建应用程序
  2. 选择 通用应用程序 (OAuth 2.0)
  3. 将重定向URL设置为 http://localhost:8090/callback
  4. 在...之下 范围,选择 用户管理 并添加:
    • cloud_recording:read:content
    • cloud_recording:read:list_user_recordings
    • meeting:read:summary
    • meeting:read:list_meetings
    • user:read:user
  5. 激活应用程序
  6. 复制 客户端ID (您不需要客户端密码)

PKCE流意味着客户端密钥保留在Zoom管理控制台中,永远不需要共享。

组织注册表

如果您的组织已经设置了Zoom OAuth应用程序,安装程序将在您输入Zoom子域时自动找到客户端ID(例如。 acme 从 acme.zoom.us).

要注册您所在组织的客户ID,以便其他人可以跳过此步骤,请提交一份PR,将您的组织添加到 client_registry.json:

{
  "orgs": {
    "yourcompany": {
      "name": "Your Company",
      "client_id": "YOUR_CLIENT_ID_HERE"
    }
  }
}

客户端ID是公共标识符,可以安全提交。

工具

工具 说明
auth_status 检查ECHO是否已连接到您的Zoom帐户
list_meetings 使用云记录列出您最近的会议
get_transcript 获取特定会议的完整记录
search_transcripts 按关键字或短语搜索会议记录
meeting_summary 吸引参与者,形成简洁的对话流程
list_past_meetings 列出您最近主持的会议,包括没有录制的会议
ai_meeting_notes 获取您自己/主持的会议的AI Companion(笔记)摘要

CLI命令

命令 描述
uv run echo-login 使用您的Zoom帐户授权ECHO
uv run echo-logout 删除存储的令牌
uv run echo-mcp 运行MCP服务器

安全模型

ECHO的设计使任何组织级的秘密都不会触及你的机器。

什么 在哪里 谁控制它
客户端密码 Zoom管理控制台 Zoom管理员(从不共享)
客户ID 您的 .env file 您(公共标识符,可安全共享)
OAuth令牌 ~/.echo/tokens.json (模式600) 您(仅限于您的帐户)

它是如何工作的:

  • 您通过在浏览器中登录Zoom进行身份验证(OAuth+PKCE)
  • ECHO使用 /users/me/ 端点,因此它只能看到您的录制
  • 令牌自动刷新,因此您无需重新验证即可保持登录状态

手动设置

如果您不想使用安装程序:

git clone https://github.com/Percona-Lab/ECHO.git
cd ECHO
uv sync
cp .env.example .env        # Add your Zoom Client ID
uv run echo-login            # Authenticate with Zoom

然后添加到您的MCP客户端配置中:

{
  "mcpServers": {
    "echo": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ECHO", "echo-mcp"]
    }
  }
}

发展

uv sync
uv run echo-mcp                                          # Run server
npx @modelcontextprotocol/inspector uv run echo-mcp      # MCP Inspector

内置于