Twitch MCP 服务器

一个全面的 Twitch MCP（模型上下文协议）服务器，提供聊天管理、流媒体管理和与 AI 系统集成的 Twitch API 功能。

对于主播

• 通过 Smithery → Cursor 使用此服务器（无需本地安装）
• 快速设置指南：video-guide/final-setup-guide.md
• Smithery 服务器页面（Playground + 一键添加到 Cursor）：https://smithery.ai/server/@Eclipse-XV/twitch-mcp-smithery
• 推荐的首次测试：
  • "向聊天发送消息：Hello from MCP!"
  • "创建一个名为 'Which map?' 的投票，选项为 'A, B'，持续时间为 60 秒"

注意：操作以您的主播账户身份运行。首先在 Smithery Playground 中进行测试，然后使用连接部分的一键添加到 Cursor 并批准。

概述

此 MCP 服务器允许 AI 代理通过一组标准化工具与 Twitch 流媒体互动。它支持以下功能：

• 向聊天发送消息
• 创建投票和预测
• 生成剪辑
• 分析聊天中的趋势和话题
• 聊天管理（超时/封禁用户）
• 更新流媒体标题和类别

开始使用

先决条件

• 安装 Node.js 18+
• Twitch API 凭证（客户端 ID 和 OAuth 令牌）
• 具有适当权限的 Twitch 频道

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

配置

连接到服务器时需要提供 Twitch API 凭证。以下配置选项是必需的：

参数	描述
twitchClientId	您的 Twitch 应用程序客户端 ID
twitchAuthToken	OAuth 令牌（不带 'oauth:' 前缀）
twitchBroadcasterId	您的 Twitch 用户 ID
twitchChannel	您的 Twitch 频道名称

在 Smithery 上部署

此服务器已配置为在 Smithery 上轻松部署。

1. 将此仓库推送到 GitHub
2. 将您的 GitHub 账户连接到 Smithery
3. 创建一个新的部署，选择此仓库
4. 在 Smithery 控制面板中配置您的 Twitch API 凭证

可用工具

聊天互动

• sendMessageToChat：向 Twitch 聊天发送消息
• getRecentChatLog：获取最近 20 条聊天消息作为上下文
• analyzeChat：分析聊天中的主题和活动

流媒体管理

• createTwitchPoll：创建具有多个选项的投票
• createTwitchPrediction：创建具有结果的预测
• createTwitchClip：创建当前流媒体的剪辑
• updateStreamTitle：更改流媒体标题
• updateStreamCategory：更改游戏/类别

管理

• timeoutUser：对用户进行指定时长的超时处理
• banUser：永久封禁用户

高级功能

智能用户解析

执行管理动作时，您可以提供：

1. 精确用户名
2. 行为描述符（例如，“有毒”，“垃圾邮件”）
3. 部分用户名匹配

服务器将尝试根据聊天历史记录解析合适的用户。

智能超时时长

超时工具会根据提供的原因严重性自动建议适当的时长：

• 垃圾邮件/过度表情符号：5 分钟
• 有毒行为：30 分钟
• 严重违规：60 分钟
• 其他违规：10 分钟（默认）

已知问题及限制

图像描述支持

虽然 AI 助手（如 Cursor/Claude）可以处理和描述图像，但在使用 Twitch MCP 服务器时有一些注意事项：

• 图像处理：图像分析由 AI 客户端处理，而不是 MCP 服务器本身
• 消息长度：AI 生成的描述可能很长。Twitch 聊天每条消息限制为 500 字符
• 自动截断：sendMessageToChat 工具现在会自动截断超过 500 字符的消息，并在发生这种情况时通知您
• 解决方法：对于详细的图像描述，请考虑让 AI 提供适合聊天的简短摘要

其他注意事项

• API 请求速率限制：Twitch API 有速率限制，可能会影响快速连续调用
• 权限：确保您的 Twitch 令牌具有所需功能的所有必要范围
• 流媒体状态：某些工具（如创建剪辑）需要活跃的流媒体

许可

ISC

致谢

基于 Twitch-MCP 的原始 Java 实现。 </中文翻译>