Twitch MCP Server

🚀 Twitch MCP Server

A Model Context Protocol (MCP) server that interacts with the Twitch API. This server uses the Twitch Helix API to retrieve channel information, stream details, game data, etc.

🚀 Quick Start

✨ Features

• Retrieve channel information (profile, description, creation date, etc.)
• Retrieve live stream information (title, game, viewer count, start time, etc.)
• Get a list of popular games
• Search for categories/games
• Search for channels
• Get live streams (filterable by game and language)
• Get global emotes
• Get global chat badges
• Get user information
• Get clips from a specified channel
• Get chat settings
• Get videos from a specified channel
• Get comments on archived videos via the GraphQL API

📦 Installation

• Prerequisites:

  • Node.js (version 18 or higher recommended)
  • A Twitch developer account
  • Twitch API client ID and client secret
  • Twitch GraphQL client ID (for the video comments feature)

• Install the package using npm:

npm install @mtane0412/twitch-mcp-server

Configuration

1. Create a new application in the Twitch Developer Console.
2. Set the following environment variables:

# macOS/Linux
export TWITCH_CLIENT_ID="your_client_id"
export TWITCH_CLIENT_SECRET="your_client_secret"

# Windows (PowerShell)
$env:TWITCH_CLIENT_ID="your_client_id"
$env:TWITCH_CLIENT_SECRET="your_client_secret"

Alternatively, you can create a .env file:

TWITCH_CLIENT_ID=your_client_id
TWITCH_CLIENT_SECRET=your_client_secret

💻 Usage Examples

Basic Usage

After installation, start the server by running the following command:

npx @mtane0412/twitch-mcp-server

Advanced Usage

Debugging: Since the MCP server communicates via standard input and output, debugging can be challenging. We recommend using the MCP Inspector, which can be run via a package script:

npm run inspect

The inspector will provide a URL to access browser debugging tools.

📄 License

MIT License