SR P3

Provides access to SR P3 music playlist data via MCP, including current playback, historical searches, and artist filtering.

typescript

1

GitHub Stars

typescript

Language

3 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": {
    "tomellen-mcpsrtest": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcpsrtest/dist/server.js"
      ]
    }
  }
}

You host an MCP server that gives access to SR P3’s current and historical playlists. It lets you fetch the currently playing song, search past playlists by date, and filter results by artist, all with built‑in rate limiting and input validation to keep things reliable.

How to use

To use this MCP server, start the local server process and connect an MCP client to the stdio transport. You’ll be able to request the current playlist data in real time and perform date‑based searches on P3’s history. The server handles input validation, enforces a safe rate limit, and returns user‑friendly error messages when something goes wrong.

Practical capabilities you can rely on include getting the current, previous, and next songs, performing date or date‑range searches for the last 90 days, and optionally filtering results by artist. The server presents results with clear metadata such as the channel, timestamps, and query details.

If you’re configuring an MCP client, use the stdio connection method shown below. This runs the server locally and communicates over standard input/output.

{
  "mcpServers": {
    "sr_p3": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcpsrtest/dist/server.js"
      ]
    }
  }
}

Available tools

get_p3_current_playlist

Fetches the currently playing song on SR P3, including current, previous, and next songs with associated metadata.

search_p3_playlist_by_date

Searches P3’s playlist history by a specific date or date range and supports an optional artist filter and result limit.