StreamerSongList MCP Server

MCP server exposing read-only StreamerSongList tools. Use LLM's to interface with a Live Streamers Song list. 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.

Click on the smithery badge to test out the mcp server or deploy your own.

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

Deploy to Smithery.ai

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!

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 (6 Total)

✅ All Real API Data (6 tools)

• 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

Usage Examples

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}}

API Status

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

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

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.

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

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.

Credits

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