🚀 Twitch MCP Server
Twitch MCP（模型上下文协议）服务器功能全面，为人工智能系统提供聊天审核、直播管理以及Twitch API集成服务。
🚀 快速开始
前提条件
- 安装Node.js 18+
- 获取Twitch API凭证（客户端ID和OAuth令牌）
- 拥有具备相应权限的Twitch频道
安装
- 克隆此仓库
- 安装依赖：
npm install
配置
连接服务器时，你需要提供Twitch API凭证。以下是必需的配置选项：
| 参数 | 描述 |
|---|---|
twitchClientId |
你的Twitch应用客户端ID |
twitchAuthToken |
OAuth令牌（无需'oauth:'前缀） |
twitchBroadcasterId |
你的Twitch用户ID |
twitchChannel |
你的Twitch频道名称 |
在Smithery上部署
此服务器已配置为可在Smithery上轻松部署。
- 将此仓库推送到GitHub
- 将你的GitHub账户连接到Smithery
- 创建新的部署，选择此仓库
- 在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：永久封禁用户的聊天权限
高级功能
智能用户解析
执行审核操作时，你可以提供以下任意一种信息：
- 准确的用户名
- 行为描述符（例如，“toxic”、“spam”）
- 部分用户名匹配
服务器将根据聊天历史尝试解析出合适的用户。
智能禁言时长
禁言工具会根据提供的违规原因严重程度自动建议合适的时长：
- 垃圾信息/过度使用表情符号：5分钟
- 不良行为：30分钟
- 严重违规：60分钟
- 其他违规：10分钟（默认）
📚 详细文档
已知问题与限制
图像描述支持
虽然人工智能助手（如Cursor/Claude）可以处理和描述图像，但在Twitch MCP服务器中使用时需要考虑以下几点：
- 图像处理：图像分析由人工智能客户端处理，而非MCP服务器本身
- 消息长度：人工智能生成的描述可能很长。Twitch聊天每条消息限制为500个字符
- 自动截断：
sendMessageToChat工具现在会自动截断超过500个字符的消息，并在发生截断时通知你 - 解决方法：对于详细的图像描述，可考虑要求人工智能提供适合聊天的简短摘要
其他注意事项
- API速率限制：Twitch API有速率限制，可能会影响连续快速调用
- 权限：确保你的Twitch令牌具备所有所需功能的必要权限范围
- 直播状态：某些工具（如创建剪辑）需要直播处于活动状态
📄 许可证
ISC
致谢
基于Twitch - MCP的原始Java实现。