voidtype/slsk_mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

5 stars 3 forks Качество 68 Тренд 21

Repository Install

A Model Context Protocol server that gives any MCP-capable AI assistant the ability to — all through simple tool calls.

Обзор

A Model Context Protocol server that gives any MCP-capable AI assistant the ability to — all through simple tool calls. Add to your MCP config (e.g. Windsurf global settings or ~/.cursor/mcp.json). Soulseek is a peer-to-peer network — every file lives on someone else's machine. These strategies are drawn from how Nicotine+, sldl, Soularr, and SoulSync handle search and download. These strategies are also available as structured data via the slsk://search_tips resource endpoint — designed for AI agents to read programmatically. Soulseek search works by tokenizing your query and matching against every shared filename and folder path on connected peers. The server-side algorithm is a simple word-intersection: for it to match. - "Miles Davis Kind of Blue flac" is better than "jazz trumpet classic album". Include artist + album + format when known.

README

Показан фрагмент оригинального README. Открыть оригинал.

slsk-mcp

A Model Context Protocol server that gives any MCP-capable AI assistant the ability to log in to Soulseek, search the network, and download files — all through simple tool calls.

Built on aioslsk 1.4.x.

Quick Start

# Install dependencies
uv sync

# Run the server (stdio transport)
uv run python -m slsk_mcp.server

Environment Variables

Variable	Default	Description
`SLSK_USERNAME`	—	Auto-login username
`SLSK_PASSWORD`	—	Auto-login password
`SLSK_DOWNLOAD_DIR`	`./downloads`	Default download directory
`SLSK_LISTEN_PORT`	aioslsk default	Soulseek listening port
`SLSK_OBFUSCATED_PORT`	aioslsk default	Obfuscated port
`SLSK_SEARCH_TIMEOUT`	`7`	Seconds to wait for search results
`SLSK_MAX_CONCURRENT_DL`	`3`	Parallel download limit
`SLSK_MAX_CONCURRENT_SEARCH`	`4`	Parallel search ticket limit
`SLSK_MAX_CONCURRENT_OPS`	`1`	Max simultaneous socket operations

MCP Integration

Add to your MCP config (e.g. Windsurf global settings or ~/.cursor/mcp.json).

Option A — Install from GitHub (no clone needed)

{
  "mcpServers": {
    "slsk": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/voidtype/slsk_mcp.git", "slsk-mcp"],
      "env": {
        "SLSK_USERNAME": "your_username",
        "SLSK_PASSWORD": "your_password",
        "SLSK_DOWNLOAD_DIR": "/home/you/music"
      }
    }
  }
}

Option B — Local clone

git clone https://github.com/voidtype/slsk_mcp.git

{
  "mcpServers": {
    "slsk": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/slsk_mcp", "slsk-mcp"],
      "env": {
        "SLSK_USERNAME": "your_username",
        "SLSK_PASSWORD": "your_password",
        "SLSK_DOWNLOAD_DIR": "/home/you/music"
      }
    }
  }
}

Option C — pip install from GitHub

pip install git+https://github.com/voidtype/slsk_mcp.git

{
  "mcpServers": {
    "slsk": {
      "command": "slsk-mcp",
      "env": {
        "SLSK_USERNAME": "your_username",
        "SLSK_PASSWORD": "your_password",
        "SLSK_DOWNLOAD_DIR": "/home/you/music"
      }
    }
  }
}

Tools

Tool	Description
`search`	Search the network for files
`download`	Download a file from a peer
`download_status`	Poll download progress
`cancel_download`	Abort an in-progress download
`peer_status`	Check a peer’s online status, speed, queue, and free slots

Resources

URI	Description
`slsk://status`	Connection state, username, passive mode
`slsk://downloads`	All tracked downloads with progress
`slsk://search_tips`	Actionable search & download strategies (sourced from Nicotine+, sldl, Soularr, SoulSync)

Tips & Tricks

Открыть полный README на GitHub

Установка

uvx --from git+https://github.com/voidtype/slsk_mcp.git slsk-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "slsk": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/voidtype/slsk_mcp.git", "slsk-mcp"],
      "env": {
        "SLSK_USERNAME": "your_username",
        "SLSK_PASSWORD": "your_password",
        "SLSK_DOWNLOAD_DIR": "/home/you/music"
      }
    }
  }
}