Twitch MCP Smithery

🚀 Twitch MCP Server

Twitch MCP（模型上下文協議）服務器功能全面，為人工智能系統提供聊天審核、直播管理以及Twitch API集成服務。

🚀 快速開始

前提條件

• 安裝Node.js 18+
• 獲取Twitch API憑證（客戶端ID和OAuth令牌）
• 擁有具備相應權限的Twitch頻道

安裝

1. 克隆此倉庫
2. 安裝依賴：

npm install

配置

連接服務器時，你需要提供Twitch API憑證。以下是必需的配置選項：

在Smithery上部署

此服務器已配置為可在Smithery上輕鬆部署。

1. 將此倉庫推送到GitHub
2. 將你的GitHub賬戶連接到Smithery
3. 創建新的部署，選擇此倉庫
4. 在Smithery儀表板中配置你的Twitch API憑證

✨ 主要特性

此MCP服務器允許人工智能代理通過一套標準化工具與Twitch直播進行交互，支持以下操作：

• 向聊天發送消息
• 創建投票和預測
• 生成剪輯
• 分析聊天趨勢和話題
• 審核聊天（對用戶進行禁言/封禁）
• 更新直播標題和類別

📦 安裝指南

主播使用說明

• 通過Smithery → Cursor使用此服務器（無需本地安裝）
• 快速設置指南：video-guide/final-setup-guide.md
• Smithery服務器頁面（遊樂場 + 一鍵添加到Cursor）：https://smithery.ai/server/@Eclipse-XV/twitch-mcp-smithery
• 推薦的首次測試：
  • “向聊天發送消息：Hello from MCP!”
  • “創建一個標題為'Which map?'的投票，選項為'A, B'，持續60秒”

注意：操作將以你的主播賬戶運行。先在Smithery遊樂場中進行測試，然後使用“連接”部分一鍵添加到Cursor並批准。

💻 使用示例

可用工具

聊天交互

• sendMessageToChat：向Twitch聊天發送消息
• getRecentChatLog：獲取最近20條聊天消息作為上下文
• analyzeChat：分析聊天話題和活躍度

直播管理

• createTwitchPoll：創建具有多個選項的投票
• createTwitchPrediction：創建具有結果的預測
• createTwitchClip：創建當前直播的剪輯
• updateStreamTitle：更改直播標題
• updateStreamCategory：更改遊戲/類別

審核

• timeoutUser：對用戶進行指定時長的禁言
• banUser：永久封禁用戶的聊天權限

高級功能

智能用戶解析

執行審核操作時，你可以提供以下任意一種信息：

1. 準確的用戶名
2. 行為描述符（例如，“toxic”、“spam”）
3. 部分用戶名匹配

服務器將根據聊天曆史嘗試解析出合適的用戶。

智能禁言時長

禁言工具會根據提供的違規原因嚴重程度自動建議合適的時長：

• 垃圾信息/過度使用表情符號：5分鐘
• 不良行為：30分鐘
• 嚴重違規：60分鐘
• 其他違規：10分鐘（默認）

📚 詳細文檔

已知問題與限制

圖像描述支持

雖然人工智能助手（如Cursor/Claude）可以處理和描述圖像，但在Twitch MCP服務器中使用時需要考慮以下幾點：

• 圖像處理：圖像分析由人工智能客戶端處理，而非MCP服務器本身
• 消息長度：人工智能生成的描述可能很長。Twitch聊天每條消息限制為500個字符
• 自動截斷：sendMessageToChat工具現在會自動截斷超過500個字符的消息，並在發生截斷時通知你
• 解決方法：對於詳細的圖像描述，可考慮要求人工智能提供適合聊天的簡短摘要

其他注意事項

• API速率限制：Twitch API有速率限制，可能會影響連續快速調用
• 權限：確保你的Twitch令牌具備所有所需功能的必要權限範圍
• 直播狀態：某些工具（如創建剪輯）需要直播處於活動狀態

📄 許可證

ISC

致謝

基於Twitch - MCP的原始Java實現。