Zoom MCP Server

Zoom MCP 服务

一个适用于 Zoom 的模型上下文协议（MCP）服务实现，为 AI 模型提供访问 Zoom API 功能的能力。

概述

本项目实现了一个 MCP 服务，可让 Claude 连接 Zoom、检索数据，并通过 Zoom API 执行操作。它充当 Claude 与 Zoom 之间的桥梁，可无缝集成并访问 Zoom 会议、用户和录制内容。

功能

• 使用服务间 OAuth 2.0 身份验证连接 Zoom
• 检索用户信息和个人资料
• 访问会议详情和录制内容
• 查询 Zoom 账户设置和配置
• 通过标准化 API 管理 Zoom 资源
• 提供调试模式，用于排查 API 连接问题

安装

前置条件

• Python 3.11 或更高版本
• 具有管理员权限的 Zoom 账户
• 具有相应作用域的 Zoom 服务间 OAuth 应用
• 用于管理 Python 软件包的 uv

设置

1. 克隆仓库：

   git clone https://github.com/yourusername/zoom-mcp.git
   cd zoom-mcp
   

2. 使用 uv 创建并激活虚拟环境：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 使用 uv 安装依赖项：

   uv pip install -e .
   

4. 设置 Zoom API 凭据：

   python scripts/setup_zoom_auth.py
   

   此脚本将引导你在 .env 文件中设置 Zoom API 凭据：

   ZOOM_API_KEY=your-client-id
   ZOOM_API_SECRET=your-client-secret
   ZOOM_ACCOUNT_ID=your-account-id
   

用法

测试连接

设置凭据后，你可以测试与 Zoom API 的连接：

python scripts/test_zoom_connection.py

此脚本将验证：

• 环境变量是否已正确设置
• OAuth 令牌生成是否正常
• 基本 API 访问是否成功

API 端点

MCP 服务提供对各种 Zoom API 端点的访问：

• /users/me - 获取已通过身份验证的用户的信息
• 将根据需要实现其他端点

身份验证

本项目使用 Zoom 的服务间 OAuth 2.0 身份验证。身份验证模块负责处理：

• OAuth 2.0 令牌生成
• 令牌缓存和续期
• 环境变量配置

身份验证流程：

1. 对 API Key 和 Secret 进行 Base64 编码，以用于基本身份验证
2. 从 Zoom 的 OAuth 端点请求访问令牌
3. 使用该令牌发送后续 API 请求
4. 在令牌过期时自动刷新

开发

创建 Zoom 应用

1. 前往 Zoom App Marketplace 并登录
2. 点击右上角的“Develop”，然后选择“Build App”
3. 选择“Server-to-Server OAuth”应用类型
4. 填写应用所需的信息
5. 在“Scopes”部分添加以下作用域：
   • user:read:admin（基本用户信息所需）
   • 根据具体用例添加其他所需作用域

运行测试

python -m pytest

代码风格

本项目遵循 PEP 8 指南。你可以使用以下命令检查代码风格：

uv pip install flake8
flake8 src tests

故障排除

如果你在连接 Zoom API 时遇到问题：

1. 身份验证错误

   • 确认 API Key 和 Secret 正确无误
   • 确保应用已启用必要的作用域
   • 在 Zoom Marketplace 中停用并重新激活应用

2. 权限错误

   • 检查账户是否具有所需权限
   • 确认请求的作用域与要访问的端点相匹配

3. 账户 ID 问题

   • 确保使用的是 Zoom 账户资料中的正确 Account ID
   • 服务间 OAuth 应用需要 Account ID

参与贡献

欢迎参与贡献！请随时提交 Pull Request。

1. 复刻仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。