Soulseek

Provides MCP access to search and download music files from the Soulseek network.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months 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": {
    "jotraynor-soulseekmcp": {
      "command": "node",
      "args": [
        "path/to/SoulseekMCP/dist/index.js"
      ],
      "env": {
        "DOWNLOAD_PATH": "/path/to/downloads",
        "SOULSEEK_PASSWORD": "your-password",
        "SOULSEEK_USERNAME": "your-username"
      }
    }
  }
}

You can run the Soulseek MCP Server to enable Claude to search for and download music files over the Soulseek peer-to-peer network using MCP endpoints. It provides practical, programmatic access to search results, initiate downloads, and check connection status, all from an MCP client.

How to use

You will run a local MCP server that exposes three core actions: search to find files on Soulseek, download to fetch a file from a peer, and get_status to verify the connection to Soulseek. Start the server with the Node runtime and point it at the built distribution, supplying your Soulseek credentials and a download directory. Once running, configure your MCP client to connect to this local server and invoke the available tools to perform searches, initiate downloads, and monitor the connection.

How to install

Prerequisites: install Node.js 18+ and create a Soulseek account at slsknet.org.

Step by step commands you should run:

npm install

Build the project to produce the runnable distribution.

npm run build

Run the server using the explicit Node command shown in the configuration snippet.

node path/to/SoulseekMCP/dist/index.js

Configuration and usage notes

Set the following environment variables when you run the server:

{ "SOULSEEK_USERNAME": "your-username", "SOULSEEK_PASSWORD": "your-password", "DOWNLOAD_PATH": "/path/to/downloads" }

Available tools

search

Search for files on the Soulseek network. Parameters: query (string, required) and limit (number, optional; default 50)

download

Download a file from a Soulseek peer. Parameters: username (string, required) and filename (string, required)

get_status

Check the connection status to the Soulseek network.