StreamerSongList

A Model Context Protocol server for StreamerSongList APIs - works with Claude Desktop and other MCP clients

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vuvuvu-streamersonglist-mcp": {
      "command": "npx",
      "args": [
        "streamersonglist-mcp"
      ],
      "env": {
        "SSL_API_BASE": "https://api.streamersonglist.com/v1",
        "DEFAULT_STREAMER": "public_streamer"
      }
    }
  }
}

You can access the StreamerSongList MCP Server to read data from the StreamerSongList API through a lightweight MCP interface. Use it with Claude Desktop or any MCP client to query streamer details, song queues, and song libraries in a structured, low-latency way.

How to use

Connect your MCP client to the StreamerSongList MCP Server to access read-only tools. You can run the server locally with the provided npx command or test it quickly via a hosted environment. Once connected, you can search for songs, fetch streamer configurations, inspect queues, and monitor changes in real time.

How to install

Prerequisites: Node.js 18+ must be installed on your machine.

Install and run the MCP server locally using the following configuration snippet. This starts an MCP server named streamersonglist that you can invoke through npx.

{
  "mcpServers": {
    "streamersonglist": {
      "command": "npx",
      "args": ["streamersonglist-mcp"]
    }
  }
}

Additional configuration and usage notes

Optional environment settings allow you to set a default streamer and tailor API interactions. The following configuration demonstrates how to set a default streamer using an environment variable.

{
  "mcpServers": {
    "streamersonglist": {
      "command": "npx",
      "args": ["streamersonglist-mcp"],
      "env": { "DEFAULT_STREAMER": "public_streamer" }
    }
  }
}

Testing and debugging

You can inspect available tools and interactively test requests using the MCP Inspector toolchain. This helps you verify tool behavior and responses in real time.

# Run the inspector against the local server
npx @modelcontextprotocol/inspector@latest -- npx streamersonglist-mcp
# or run the server directly from source
npx @modelcontextprotocol/inspector@latest -- node src/server.js

Available tools

getStreamerByName

Fetches comprehensive streamer configuration and metadata by streamer name.

getQueue

Retrieves the current song queue for a streamer, with pagination support.

getSongs

Returns the complete song list available for a streamer, with optional pagination.

searchSongs

Searches songs by title or artist for a given streamer.

getSongDetails

Provides detailed information about a specific song, including metadata.

monitorQueue

Monitors queue changes in real time to reflect updates as they occur.