Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Soulseek MCP Serversearch for 'Radiohead In Rainbows' and download the first result"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Soulseek MCP Server
An MCP (Model Context Protocol) server that enables Claude to search and download music files from the Soulseek peer-to-peer network.
Prerequisites
Node.js 18+
A Soulseek account (create one at slsknet.org)
Installation
Clone the repository:
git clone <repository-url> cd SoulseekMCPInstall dependencies:
npm installBuild the project:
npm run build
Configuration
Set the following environment variables:
Variable | Required | Description |
| Yes | Your Soulseek account username |
| Yes | Your Soulseek account password |
| No | Directory for downloaded files (default: |
Usage with Claude Desktop
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Available Tools
search
Search for files on the Soulseek network.
Parameters:
query(string, required): Search query (artist, song title, album, etc.)limit(number, optional): Maximum results to return (default: 50)
download
Download a file from a Soulseek peer.
Parameters:
username(string, required): Username of the peer (from search results)filename(string, required): Full file path (from search results)
get_status
Check the connection status to the Soulseek network.
Development
Watch mode for development:
License
MIT