Zoom MCP

🚀 Zoom MCP 服務器

本項目實現了一個為Zoom打造的模型上下文協議（MCP）服務器，藉助該服務器，AI模型能夠通過Zoom的API功能進行數據訪問，實現與Zoom的無縫對接。

🚀 快速開始

本項目實現了MCP服務器，讓Claude能夠連接到Zoom，獲取所需數據並通過Zoom API執行操作。它就像一座橋樑，架設在Claude和Zoom之間，實現了兩者的無縫集成，使得用戶能夠訪問Zoom會議、用戶和錄音等信息。

✨ 主要特性

• 運用Server-to-Server OAuth 2.0身份驗證機制連接到Zoom。
• 可獲取用戶信息和配置文件。
• 支持訪問會議詳細信息和錄音。
• 能夠查詢Zoom賬戶設置和配置。
• 提供管理Zoom資源的標準API。
• 具備調試模式，方便對API連接進行故障排除。

📦 安裝指南

先決條件

• 需要Python 3.11或更高版本。
• 要有帶有管理權限的Zoom賬戶。
• 需創建帶有適當範圍的Zoom服務器間OAuth應用程序。
• 使用uv進行Python包管理。

設置步驟

1. 克隆倉庫：

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

2. 創建虛擬環境並使用uv激活它：

uv venv
source .venv/bin/activate  # 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的Server-to-Server OAuth 2.0身份驗證。認證模塊負責處理以下內容：

• OAuth 2.0令牌生成。
• 令牌緩存和刷新。
• 環境變量配置。

認證流程如下：

1. 將API密鑰和秘密進行Base64編碼以用於基本認證。
2. 向Zoom的OAuth端點請求訪問令牌。
3. 使用令牌進行後續API請求。
4. 在令牌過期時自動刷新。

開發

創建一個Zoom應用程序

1. 訪問Zoom App Marketplace並登錄。
2. 點擊右上角的“Develop”並在菜單中選擇“構建”。
3. 在應用詳細信息部分，輸入應用名稱、描述和同意URL。
4. 轉到“高級設置”，啟用OAuth 2.0身份驗證，併為用戶授權設置回調URL。
5. 保存更改並獲取客戶的ID和秘密以進行API連接。

訪問權限

創建應用程序後，需要授予必要的權限以便與Zoom API交互。以下是常用的權限：

• zoom_basic - 基本訪問（讀取會議、用戶信息等）。
• zoom_video - 視頻會議控制。
• zoom_audit_logs - 審計日誌訪問。
• 可根據API需求選擇其他權限。

配置示例

在項目根目錄中創建一個.env文件，並添加以下內容以配置Zoom API：

ZOOM_CLIENT_ID=your-client-id
ZOOM_CLIENT_SECRET=your-client-secret
ZOOM_API_KEY=your-api-key
ZOOM_API_SECRET=your-api-secret

故障排除

無法連接到Zoom API

• 檢查API密鑰和秘密是否正確配置。
• 確保應用程序權限已啟用。
• 查看Zoom文檔以確認API端點和參數的正確性。

認證失敗

• 驗證OAuth令牌是否有效。
• 確保回調URL在Zoom應用中正確設置。
• 檢查請求頭中的Authorization字段是否正確格式化。

貢獻

我們歡迎社區貢獻！如果你有任何問題、建議或功能請求，請提交GitHub問題。

📄 許可證

該項目受MIT License保護。