Skip to main content
Glama
ldgnu
by ldgnu

MCP Soulseek (slskd)

License: MIT

Model Context Protocol (MCP) server for searching and downloading music from the Soulseek peer-to-peer network via slskd.

This server exposes Soulseek's search and download capabilities as MCP tools, allowing AI assistants (Claude, Hermes, etc.) to discover and download music directly.

Tools

Tool

Description

search_music(query, limit)

Search for music files on Soulseek

download_music(username, filename, size)

Download a file from a user

download_status()

Check progress of active downloads

browse_user(username)

Browse a user's shared files

search_last_results(query)

Get cached results from last search

Related MCP server: slskd-mcp

Prerequisites

  • slskd instance running and connected to Soulseek

  • Python 3.11+

Quick Start

1. Environment

export SLSKD_HOST="http://localhost:5030"
export SLSKD_USER="slskd"
export SLSKD_PASS="slskd"
uv run python -m mcp_slskd

3. Run with pip

pip install mcp slskd-api
python -m mcp_slskd

4. Run with Docker

docker run -e SLSKD_HOST=http://host.docker.internal:5030 \
  -e SLSKD_USER=slskd \
  -e SLSKD_PASS=slskd \
  ghcr.io/ldgnu/mcp-slskd:latest

Docker Compose

services:
  slskd:
    image: slskd/slskd:latest
    ports:
      - "5030:5030"
    volumes:
      - ./slskd_data:/app/data

  mcp-slskd:
    image: ghcr.io/ldgnu/mcp-slskd:latest
    environment:
      SLSKD_HOST: "http://slskd:5030"
      SLSKD_USER: "slskd"
      SLSKD_PASS: "slskd"
    depends_on:
      - slskd

MCP Client Configuration

Hermes Agent

Add to your config.yaml:

mcp_servers:
  slskd:
    command: docker
    args: [run, -i, --rm, --network=host,
      -e, SLSKD_HOST=http://localhost:5030,
      -e, SLSKD_USER=slskd,
      -e, SLSKD_PASS=slskd,
      ghcr.io/ldgnu/mcp-slskd:latest]

Claude Desktop

{
  "mcpServers": {
    "soulseek": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network=host",
        "-e", "SLSKD_HOST=http://localhost:5030",
        "-e", "SLSKD_USER=slskd",
        "-e", "SLSKD_PASS=slskd",
        "ghcr.io/ldgnu/mcp-slskd:latest"
      ]
    }
  }
}

Configuration

Variable

Default

Description

SLSKD_HOST

http://127.0.0.1:5030

slskd API endpoint

SLSKD_API_KEY

""

API key (alternative to user/pass)

SLSKD_USER

slskd

slskd web UI username

SLSKD_PASS

slskd

slskd web UI password

Note: Change default credentials in production. slskd uses token-based auth internally.

API

This server wraps the slskd REST API.

License

MIT

Install Server
F
license - not found
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    An MCP server that gives AI agents full control over slskd, a modern Soulseek client, enabling search, download, browse peers, monitor transfers, and manage the slskd instance.
    Last updated
    1
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server that enables AI assistants to search and retrieve music data (songs, lyrics, playlists, albums, artists) from Netease Cloud Music.
    Last updated
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    An MCP server that enables AI assistants to log into Soulseek, search the network, and download files through simple tool calls.
    Last updated

View all related MCP servers

Related MCP Connectors

  • MCP server for Producer/Riffusion AI music generation

  • MCP server for Suno AI music generation, lyrics, and covers

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ldgnu/mcp-slskd'

If you have feedback or need assistance with the MCP directory API, please join our Discord server