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实现。