Twitch Chat and Stream Management Server

Twitch MCP 服务

一款功能全面的 Twitch MCP（Model Context Protocol）服务，为 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 中测试，然后使用 Connect 部分一键添加到 Cursor 并批准。

概览

此 MCP 服务允许 AI Agent 通过一组标准化工具与 Twitch 直播互动。支持：

• 向聊天室发送消息
• 创建投票和预测
• 生成剪辑
• 分析聊天内容中的趋势和话题
• 管理聊天（禁言/封禁用户）
• 更新直播标题和分类

入门

前提条件

• 已安装 Node.js 18+
• Twitch API 凭据（Client 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 实现。