streamersonglist-mcp

vuvuvu/streamersonglist-mcp

3.3

If you are the rightful owner of streamersonglist-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

StreamerSongList MCP Server provides tools for interacting with StreamerSongList APIs, enabling AI assistants to manage song requests and monitor queues.

Tools
5
Resources
0
Prompts
0

StreamerSongList MCP Server

Test MCP Server License: MIT Node.js Version smithery badge

MCP server exposing read-only StreamerSongList tools. Works with Claude Desktop and any MCP client.

Quick Start

  • Node.js 18+ required
  • Claude Desktop recommended for daily use

Add to Claude Desktop via npx:

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

See claude-desktop-config.with-default-streamer.json for an example with DEFAULT_STREAMER configured.

Optional Smithery install:

npx -y @smithery/cli install @vuvuvu/streamersonglist-mcp --client claude

Inspect / Debug (Recommended)

Use the MCP Inspector to explore tools and run requests interactively:

npx @modelcontextprotocol/inspector@latest -- npx streamersonglist-mcp
# or from a local clone
npx @modelcontextprotocol/inspector@latest -- node src/server.js

Alternative (raw stdio):

npm start
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}\n' | node src/server.js

Available Tools (4 Total)

✅ Real API Data (3 tools)

  • getStreamerByName — Fetch comprehensive streamer configuration
  • getQueue — List current song queue with pagination
  • monitorQueue — Monitor queue changes using real data

⚠️ Simulated Data (1 tool)

  • getQueueStats — Queue statistics (API endpoint returns 404, uses realistic mock data)

API Status

Working Endpoints: 3 out of 4 implemented tools use real API data

  • Streamer information and queue management available
  • No authentication required for public endpoints
  • Queue statistics simulated (endpoint returns 404)

For detailed API testing results, see

Environment

Optionally set a default streamer used when streamerName is omitted:

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

CLI override examples:

DEFAULT_STREAMER=public_streamer npx streamersonglist-mcp
npx streamersonglist-mcp --streamer public_streamer

Security tip: use only public streamer names; the server calls public read-only endpoints.

Scripts

  • npm install — install dependencies
  • npm start — run server on stdio
  • npm test — spawn server and verify tools/list
  • npm run setup — generate Claude Desktop entries

License

MIT — see LICENSE.

Contributing

PRs welcome. Please run npm test before submitting.