Twitch Chat and Stream Management Server

Twitch MCP サーバー

AI システム向けに、チャットのモデレーション、配信管理、Twitch API との統合を提供する包括的な Twitch MCP（Model Context Protocol）サーバーです。

配信者向け

• Smithery → Cursor 経由でこのサーバーを使用できます（ローカルへのインストールは不要です）
• クイックセットアップガイド：video-guide/final-setup-guide.md
• Smithery サーバーページ（Playground ＋ Cursor へのワンクリック追加）：https://smithery.ai/server/@Eclipse-XV/twitch-mcp-smithery
• 最初におすすめするテスト：
  • 「チャットにメッセージを送信：MCP からこんにちは！」
  • 「『どのマップ？』というタイトルで、選択肢『A、B』の 60 秒間のアンケートを作成」

注：アクションは配信者アカウントとして実行されます。まず Smithery Playground でテストし、その後 Connect セクションから Cursor にワンクリックで追加して承認してください。

概要

この MCP サーバーを使用すると、AI エージェントが標準化された一連のツールを通じて Twitch の配信とやり取りできます。次の機能をサポートしています。

• チャットへのメッセージ送信
• アンケートと予測の作成
• クリップの生成
• トレンドやトピックを把握するためのチャット分析
• チャットのモデレーション（ユーザーのタイムアウト／BAN）
• 配信タイトルとカテゴリーの更新

はじめに

前提条件

• 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：ユーザーをチャットから永久に BAN します

高度な機能

ユーザーのスマート解決

モデレーション操作を行う際、次のいずれかを指定できます。

1. 正確なユーザー名
2. 行動の説明（例：「有害」「スパム」）
3. ユーザー名の一部

サーバーはチャット履歴に基づいて、該当するユーザーの特定を試みます。

タイムアウト時間のインテリジェントな設定

タイムアウトツールは、指定された理由の深刻度に基づいて適切な時間を自動で提案します。

• スパム／過度なエモート：5 分
• 有害な行動：30 分
• 重大な違反：60 分
• その他の違反：10 分（デフォルト）

既知の問題と制限事項

画像の説明のサポート

AI アシスタント（Cursor／Claude など）は画像を処理して説明できますが、Twitch MCP サーバーでこの機能を使う際には、いくつか考慮事項があります。

• 画像処理：画像分析は MCP サーバー自体ではなく、AI クライアントが行います
• メッセージの長さ：AI が生成する説明は非常に長くなることがあります。Twitch チャットのメッセージは 500 文字までです
• 自動切り詰め：sendMessageToChat ツールは、500 文字を超えるメッセージを自動的に切り詰め、切り詰めが行われたことを通知するようになりました
• 回避策：画像を詳しく説明する場合は、チャットに適した短い要約を AI に依頼することを検討してください

その他の考慮事項

• API レート制限：Twitch API にはレート制限があり、短時間に連続して呼び出すと影響を受ける場合があります。
• 権限：必要なすべての機能を利用するには、Twitch トークンに適切なスコープが設定されていることを確認してください。
• 配信状況：クリップの作成など、一部のツールでは配信がアクティブである必要があります。

ライセンス

ISC

クレジット

Twitch-MCP の元となった Java 実装に基づいています。