Music Player MCP Server

A music player MCP server built with mcp-use that streams full tracks via Audius with an inline React widget featuring a multi-layer audio visualizer.

Features

• Full song streaming via Audius API (no 30s previews)

• Inline visualizer widget with 4 layers: ambient glow orbs, waveform oscilloscope, 48 frequency bars with reflections, and beat-reactive pulse line

• Deezer metadata for album art, artist info, and track details

• Playback controls: play/pause, seek, skip forward/back, volume

• Queue system: add to queue, play next, show queue

• Same-origin audio proxy to bypass CSP restrictions

Related MCP server: music-mcp-agent

Tools

Getting Started

npm install
npm run dev

Open http://localhost:3000/inspector to test your server.

Build & Run

npm run build
npm run start

Deploy

npm run deploy

Use with Cursor / Claude Desktop / ChatGPT

Add the MCP endpoint URL to your client config:

{
  "mcpServers": {
    "music-player": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Or expose via Cloudflare Tunnel for remote access:

cloudflared tunnel --url http://localhost:3001

Tech Stack

• mcp-use — MCP server framework with React widget support

• Audius API — Free full-track music streaming

• Deezer API — Track metadata and album art

• Web Audio API — Real-time audio visualization

• React + TypeScript + Tailwind CSS