使用说明
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
安装程序将引导您完成以下操作:
- 克隆ECHO并通过uv安装其Python deps
- 在公共注册表中查找您的组织(对于Percona,没有其他问题,只需输入
percona) - 在Claude Desktop、Claude Code或您拥有的任何MCP客户端上注册ECHO
- Zoom OAuth一次性登录
安装后,您的AI工具会自动获取这些斜线命令:
/echo_status, /echo_recent, /echo_search <query>, /echo_summary <id>, /echo_transcript <id>, /echo_notes <meeting>.
安装程序将指导您完成以下操作:
- 克隆仓库并安装依赖项
- 配置Zoom OAuth客户端ID(或使用注册表)
- 使用您的Zoom帐户进行身份验证
- 自动检测和配置您的AI客户端
先决条件
你需要一个 缩放OAuth客户端ID 来自通用应用程序(OAuth 2.0)。如果您有Zoom帐户的管理员或所有者访问权限,则可以自己创建。如果没有,请咨询您的Zoom管理员。
创建Zoom OAuth应用程序
- 首选 marketplace.zoom.us > 开发 > 构建应用程序
- 选择 通用应用程序 (OAuth 2.0)
- 将重定向URL设置为
http://localhost:8090/callback - 在...之下 范围,选择 用户管理 并添加:
cloud_recording:read:contentcloud_recording:read:list_user_recordingsmeeting:read:summarymeeting:read:list_meetingsuser:read:user
- 激活应用程序
- 复制 客户端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
