Twitch MCP Smithery

🚀 Twitch MCP Server

この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
• 最初にお試しいただくことをおすすめするテスト:
  • "チャットにメッセージを送信: MCPからこんにちは！"
  • "60秒間、'どのマップ？' というタイトルで 'A, B' の選択肢を持つ投票を作成"

注意: アクションはあなたの放送者アカウントで実行されます。まずSmithery Playgroundでテストし、次にConnectセクションを使用してワンクリックでCursorに追加し、承認してください。

🌐 概要

このMCPサーバーは、AIエージェントが標準化されたツールセットを通じてTwitchストリームとやり取りできるようにします。以下の機能をサポートしています:

• チャットにメッセージを送信
• 投票や予測を作成
• クリップを生成
• チャットの傾向やトピックを分析
• チャットをモデレート（ユーザーをタイムアウト/禁止）
• ストリームのタイトルとカテゴリを更新

🚀 クイックスタート

📋 前提条件

• 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の資格情報を設定します。

🛠️ 利用可能なツール

💬 チャットインタラクション

• sendMessageToChat: Twitchチャットにメッセージを送信
• getRecentChatLog: コンテキスト用に最後の20件のチャットメッセージを取得
• analyzeChat: チャットのトピックとアクティビティを分析

📺 ストリーム管理

• createTwitchPoll: 複数の選択肢を持つ投票を作成
• createTwitchPrediction: 結果を持つ予測を作成
• createTwitchClip: 現在のストリームのクリップを作成
• updateStreamTitle: ストリームのタイトルを変更
• updateStreamCategory: ゲーム/カテゴリを変更

🔒 モデレーション

• timeoutUser: 指定された期間ユーザーをタイムアウト
• banUser: ユーザーをチャットから永久に禁止

⚙️ 高度な機能

👥 スマートユーザー解決

モデレーションアクションを実行する際に、以下のいずれかを提供できます:

1. 正確なユーザー名
2. 行動の記述子（例: "toxic", "spam"）
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実装に基づいています。