JinDaGe - twitch-mcp MCP Details

article

README

🚀 Twitch MCP 服务器

Twitch MCP 服务器是一款由人工智能驱动的工具，它通过模型上下文协议（MCP）为 Twitch 主播提供支持。你可以将编码/聊天助手（如 Gemini CLI、Qwen Coder、Claude Code 等）连接到你的 Twitch 聊天中，用于聊天管理、直播管理和观众互动。

🚀 快速开始（无需克隆）

前提条件

系统的环境变量中已配置 Node.js 14 及以上版本和 Java 11 及以上版本。
拥有一个具备适当 API 凭证的 Twitch 账户。

配置设置

使用你的 Twitch 凭证创建一个配置文件（使用纯访问令牌，无需 “oauth:” 前缀）：

Windows：C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json
macOS：~/Library/Application Support/twitch-mcp/config.json
Linux：~/.config/twitch-mcp/config.json

config.json 示例：

{
  "channel": "YOUR_TWITCH_USERNAME",
  "auth": "YOUR_TWITCH_ACCESS_TOKEN",  
  "clientId": "YOUR_TWITCH_CLIENT_ID",
  "broadcasterId": "YOUR_BROADCASTER_ID",
  "showConnectionMessage": true
}

配置示例

Gemini CLI 配置

添加到你的 Gemini 设置中：

{
  "mcpServers": {
    "twitch-mcp": {
      "type": "stdio", 
      "command": "npx",
      "args": [
        "-y",
        "twitch-mcp-server@latest",
        "--config",
        "C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json"
      ]
    }
  }
}

Qwen Coder 配置

添加到你的 Qwen 设置中：

{
  "mcpServers": {
    "twitch-mcp": {
      "type": "stdio",
      "command": "npx", 
      "args": [
        "-y",
        "twitch-mcp-server@latest",
        "--config", 
        "C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json"
      ]
    }
  }
}

✨ 主要特性

聊天管理：发送和读取消息、查看最近聊天记录、进行聊天分析。
审核管理：对用户进行禁言/封禁（通过用户名或描述关键词）。
直播管理：更新直播标题/分类、创建剪辑。
互动工具：创建投票和预测以提高观众参与度。

📦 安装指南

选项 1：NPX（推荐）

无需安装 - 你的 AI 工具将自动获取最新版本：

npx twitch-mcp-server@latest --config /path/to/config.json

选项 2：全局安装

npm install -g twitch-mcp-server
twitch-mcp-server --config /path/to/config.json

选项 3：本地开发

有关从源代码构建的信息，请参阅 README-developers.md。

📚 详细文档

使用注意事项

在 auth 字段中使用纯访问令牌（无需 oauth: 前缀）。
一次只能连接一个 AI 客户端，以避免冲突。
确保 Node.js 和 Java 与你的 AI 命令行工具安装在同一系统上。
服务器将自动处理 IRC 格式和 API 认证。

故障排除

认证问题：

确认 auth 是纯令牌（无 oauth: 前缀）。
验证 clientId 和权限范围与你生成的令牌匹配。
确保 broadcasterId 与你的频道 ID 匹配。

连接问题：

检查 Node.js 和 Java 是否已添加到系统的环境变量中。
尝试运行 java -version 和 node -version 以验证安装情况。
对于 Windows 用户：如果你使用的是 Windows 上的 AI 命令行工具，请确保不要在 WSL 中运行。

无头环境中的 NPX 提示：

上述配置使用 -y 标志进行非交互式执行。
如果你遇到提示，请在 npx 命令中添加 --yes。

支持

对于一般使用问题，请查看上述故障排除部分。
对于开发和贡献，请参阅 README-developers.md。
对于 Claude 特定的集成帮助，请参阅 CLAUDE.md。

twitch-mcp