MCP server exposing read-only StreamerSongList tools. Use LLM's to interface with a Live Streamers Song list. Claude Desktop and any MCP client.

• 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 (requires Smithery account):

# First login to Smithery (one-time setup)
npx -y @smithery/cli login

# Then install the MCP server
npx -y @smithery/cli install @vuvuvu/streamersonglist-mcp --client claude

Want to test this MCP server instantly without any local setup? Click the Smithery badge above or visit:

🚀 Deploy to Smithery.ai

Smithery.ai provides a hosted environment where you can:

• Test all StreamerSongList tools immediately in your browser
• No installation or configuration required
• Perfect for trying out the server before local setup
• Great for sharing with others or quick demonstrations

Simply click the badge at the top of this README or the link above to get started instantly!

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

• getStreamerByName — Fetch comprehensive streamer configuration
• getQueue — List current song queue with pagination
• getSongs — Fetch complete song list with pagination
• searchSongs — Search songs by title or artist
• getSongDetails — Get detailed information about a specific song
• monitorQueue — Monitor queue changes using real data

For comprehensive examples of how to use these tools, see docs/USAGE_EXAMPLES.md including:

• 🎵 Music discovery and analysis
• 📊 Content creator tools and stream planning
• 🤖 AI assistant integration and smart recommendations
• 📈 Data analysis and insights
• 🎪 Event planning and collaboration tools
• 🛠️ Technical applications and automation

Quick examples:

// Search for songs
{"tool": "searchSongs", "arguments": {"streamerName": "belleune", "query": "Frank Sinatra"}}

// Get most popular songs
{"tool": "getSongs", "arguments": {"streamerName": "belleune", "limit": 20}}

// Compare streamer libraries
{"tool": "getSongs", "arguments": {"streamerName": "vu_vu", "limit": 50}}

Working Endpoints: All 6 tools use real API data

• Streamer information, queue management, and full song library access
• No authentication required for public endpoints
• All features fully functional with real StreamerSongList API data

#Please be considerate when using streamersonglists api. It's a shared but limitted resource, be mindful when using LLM's to access it, Please don't ruin it for everyone!

For detailed API testing results, see docs/API_TESTING_REPORT.md

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

Configuration options:

• DEFAULT_STREAMER — default streamer when an argument is omitted
• SSL_API_BASE — override API base (default https://api.streamersonglist.com/v1)

Version info: The server reports its version from package.json, matching the published package.

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

• 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

MIT — see LICENSE.

Contributions are welcome via pull requests. Due to limitations of the public StreamerSongList API, scope for major new features is intentionally modest — helpful contributions include:

• Bug fixes, error handling, and robustness improvements
• Documentation updates and examples
• Small tooling or DX enhancements (tests, CI, config)

Please open an issue to discuss larger ideas before starting work, and run npm test before submitting PRs.

This project builds on the excellent StreamerSonglist service. All data and API functionality are provided by StreamerSonglist:

• https://www.streamersonglist.com

I am not affiliated with or endorsed by StreamerSonglist so please don't bother them with any issues you find in my code. Thankyou Streamersonglist for providing such a useful service to the streamer community. Very POG