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包管理
设置
- 克隆存储库：
git clone https://github.com/yourusername/zoom-mcp.git
cd zoom-mcp- 创建一个虚拟环境并使用uv激活它：
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate- 使用uv安装依赖项：
uv pip install -e .- 设置Zoom API凭据：
python scripts/setup_zoom_auth.py此脚本将指导您在 .env 文件：
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令牌生成
- 令牌缓存和续订
- 环境变量配置
身份验证流程：
- Base64对用于基本身份验证的API密钥和秘密进行编码
- 从Zoom的OAuth端点请求访问令牌
- 将令牌用于后续API请求
- 令牌过期时自动刷新令牌
发展
创建Zoom应用程序
- 转到 Zoom应用市场 并登录
- 点击右上角的“开发”，选择“构建应用”
- 选择“服务器到服务器OAuth”应用程序类型
- 填写应用程序所需的信息
- 在“范围”部分，添加以下范围：
- user:read:admin （需要基本用户信息） - 根据您的特定用例需要的其他范围
运行测试
python -m pytest代码的风格
本项目遵循PEP 8指南。您可以使用以下命令检查代码样式：
uv pip install flake8
flake8 src tests故障排除
如果您遇到Zoom API连接问题：
- 身份验证错误
- 验证您的API密钥和机密是否正确 - 确保你的应用程序启用了必要的作用域 - 在Zoom Marketplace中停用和重新激活您的应用程序
- 权限错误
- 检查您的帐户是否具有所需的权限 - 验证请求的作用域是否与您尝试访问的终结点匹配
- 帐户ID问题
- 确保您使用的是Zoom帐户配置文件中的正确帐户ID - 服务器到服务器OAuth应用程序需要帐户ID
贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
