Skip to main content
Glama
Happyfunnysad

arxpot-mcp

by Happyfunnysad
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Arxpot MCP

Remote MCP server for the Arxpot processing core. It gives an MCP client music search, full track/collection metadata, download jobs, job progress, history, remote storage delivery, and downloadable audio files.

arxpot-mcp is intentionally a separate service. It does not reproduce FFmpeg, matching, or downloader logic: the private Go Arxpot backend remains the single processing core.

Tools

Tool

Purpose

search_music

Search tracks, albums, and playlists.

get_track

Get metadata for a song URL or ID.

get_track_lyrics

Get plain or synchronised song lyrics.

get_collection

Get an album, playlist, or artist's tracks.

download_track

Start an audio download job.

check_download_job / wait_for_download

Read processing state and errors.

list_downloads

List the finished history items.

download_file

Return a temporary downloadable MCP resource.

send_to_storage

Deliver a history item to configured remote storage.

Related MCP server: beatport-mcp-server

Local try-out

Clone this repository next to arxpot, then run:

cp .env.example .env
docker compose -f docker-compose.local.yml up --build

The MCP endpoint is http://127.0.0.1:3000/mcp. Arxpot is not published to the host in this stack.

For local MCP clients, set MCP_AUTH_TOKEN and send Authorization: Bearer <token>. For a temporary no-auth test only, leave it blank and use a long secret MCP_PATH, such as /mcp/<random-value>.

ChatGPT and Tailscale Funnel

Run arxpot and arxpot-mcp in the same Tailscale network namespace. Funnel must proxy only the MCP container on port 3000; the Go core remains private.

tailscale funnel --bg --https=443 http://127.0.0.1:3000

Set PUBLIC_BASE_URL=https://<tailscale-host>.<tailnet>.ts.net. The download_file tool then returns a temporary URL under /files/…; the MCP service proxies the private signed Arxpot link and never reveals the core address.

For a durable ChatGPT connection, use OAuth in front of /mcp. The optional MCP_AUTH_TOKEN is for local clients and API testing, not the final ChatGPT authentication flow.

Development

npm install
npm run build
npm test

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Tempo

    amarisaster
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server for Spotify control and synchronized lyrics retrieval that enables playback management, queue navigation, and music search capabilities. It also features perception tools for real-time track analysis, including BPM, key detection, and timestamped lyrics.
    116 npm
    3
    Apache 2.0

  • beatport-mcp-server

    ivo-toby
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides access to the Beatport API for music discovery and data retrieval, enabling users to search for tracks, artists, labels, releases, and charts through natural language.
    4
    MIT

  • spotify-mcp-server

    qchuchu
    A
    license
    Not graded
    quality
    D
    maintenance
    An unofficial MCP server that provides access to Spotify's Web API through the Model Context Protocol, enabling AI assistants to search music, manage playlists, and control playback.
    6 npm
    9
    ISC