Tuisic MCP server
Commit 16. Sept. 2026Ermöglicht es einem AI-Client, Online-Musikstreaming über ein Terminal-TUI via MCP zu suchen, abzuspielen und zu verwalten.
Auch bekannt als Dark-Kernel/tuisic
- Stars
- 76
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 16. Sept. 2026
- Lizenz
- GPL-3.0
Was ist Tuisic MCP?
Tuisic ist ein MCP server. Ermöglicht es einem AI-Client, Online-Musikstreaming über ein Terminal-TUI via MCP zu suchen, abzuspielen und zu verwalten.
Zusammenfassung generiert aus dem README des Projekts
Über Tuisic MCP server
Musik über ein Terminal-Interface zu verwalten und abzuspielen, ist mit tuisic möglich. Dieses Tool erlaubt es dir, Songs zu suchen und das Streaming-Playback direkt über eine Command Line Interface mittels Vim Motions zu steuern. Es fungiert als lokaler MCP server, der sich über den Befehl tuisic --mcp-server mit AI-Clients verbindet und es einer KI ermöglicht, mit deiner Musikbibliothek und Online-Quellen zu interagieren.
Nutzer können auf Musik von verschiedenen Plattformen zugreifen, darunter SoundCloud, YouTube, JioSaavn und LastFM. Der Server verwaltet auch lokale Musikdateien, indem er ein konfiguriertes Verzeichnis scannt – wie etwa den Standardpfad ~/Music – und diese über mpv abspielt. Über das einfache Abspielen hinaus unterstützt es Features wie Playlist-Management, Song-Downloads und eine Favoritenliste. Es integriert sich in System-Tools wie playerctl für MPRIS-Support und kann während des Playbacks Lyrics anzeigen oder einen Cava-Visualizer nutzen.
Was du damit machen kannst
- 1Online-Musik suchen und abspielenBitte deinen AI-Client, einen bestimmten Song von SoundCloud oder YouTube zu finden und abzuspielen.
- 2Lokale Musikbibliotheken verwaltenGib der KI den Befehl, deinen lokalen Musikordner zu scannen und Dateien aus deiner persönlichen Sammlung abzuspielen.
- 3Songs für die Offline-Nutzung herunterladenLass deinen AI-Assistenten einen Track herunterladen, den du gerade hörst.
- 4Musik-Favoriten organisierenSage der KI, den aktuellen Track zu deiner Liste der Lieblingssongs hinzuzufügen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Konfiguration
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Name | Beschreibung | Typ |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenTUISIC
TUI Online Music Streaming application with MCP support
https://github.com/user-attachments/assets/ef349a06-0d7e-488b-aa3d-de928d9b0eef
First app of its kind, It let's you search and play online songs from cli hassle free. Now it supports AI integration through MCP (BETA). Checkout Demo's below
Features
- Vim motions
- No browser, No Ads
- Easy downloads
- Multiple song sources
- Playlist support
- Easy Sharing
- Favourites List
- Configuration file
- Daemon mode (BETA, press 'w' to toggle)
- MPRIS DBUS support ( via
playerctl) - Cava Visualizer (BETA)
- Support for AI Integration via MCP (BETA)
- Support for Discord Rich Presence
- Lyrics support (BETA)
- Local music library playback
When Local Music is selected from the playlist menu, Tuisic scans the path
configured under local_music.path recursively. The default is ~/Music,
which includes the requested ~/Music/mp4s/mp3s layout. Local files are played
directly through mpv, so online search and local playback can be switched
between at any time. For example:
"local_music": {
"path": "/home/user/Music"
}
Shortcuts
| Key | Action |
|---|---|
q |
quit |
w |
toggle daemon mode |
> |
next song |
< |
previous song |
<space> |
play/pause |
Alt+l |
copy url |
d |
download song |
a |
add to favourites |
. |
seek forward |
, |
seek backward |
m |
mute |
L |
Toggle lyrics |
Sources
It fetches songs from some platforms:
- JioSaavn
- SoundCloud
- LastFM
- ForestFM
- YouTube
- YouTube Music (on the way)
Installation:
yay -S tuisic-git
Building from source
Build Options
| CMake Flag | Description | Default |
|---|---|---|
-DWITH_MPRIS |
Enable MPRIS (sdbus-c++) support | ON |
-DWITH_CAVA |
Enable Cavacore-based visualizer | OFF |
-DWITH_DISCORD |
Enable Discord Rich Presence | OFF |
Before Installation
Update the desktop/tuisic.desktop file.
Exec=alacritty -e tuisic # Change terminal accordingly
Debian
- Install dependencies
sudo apt-get update
sudo apt-get install -y build-essential cmake pkg-config libfftw3-dev libmpv-dev libcurl4-openssl-dev libfmt-dev libsystemd-dev rapidjson-dev libpulse-dev
git clone --depth 1 https://github.com/Kistler-Group/sdbus-cpp.git
cd sdbus-cpp
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
sudo cmake --build . --target install
- Build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)
Arch Linux
- Install dependencies
sudo pacman -S curl mpv fmt yt-dlp fftw sdbus-cpp rapidjson
- Build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)
MacOS
- Install dependencies
brew install cmake pkg-config fftw mpv curl fmt rapidjson
- Set environment variables for Homebrew paths
# Detect Homebrew prefix (Apple Silicon uses /opt/homebrew, Intel uses /usr/local)
BREW_PREFIX=$(brew --prefix)
export HOMEBREW_PREFIX=${BREW_PREFIX}
export PKG_CONFIG_PATH=${BREW_PREFIX}/lib/pkgconfig:${BREW_PREFIX}/opt/curl/lib/pkgconfig:${BREW_PREFIX}/opt/fmt/lib/pkgconfig
export CMAKE_PREFIX_PATH=${BREW_PREFIX}
export LDFLAGS=-L${BREW_PREFIX}/lib
export CPPFLAGS=-I${BREW_PREFIX}/include
- Build
cmake .. \
-DWITH_MPRIS=OFF \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH="${HOMEBREW_PREFIX}"
cmake --build . --config Release -j$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 2)
MISC Build, Compile & Install
mkdir build && cd build
cmake .. # -DWITH_MPRIS=OFF -DWITH_CAVA=ON
make
sudo make install
Configure MCP
Use tuisic --mcp-server command in your ai client config.
Example in .config/opencode/opencode.json:
"tuisic":{
"type": "local",
"command": ["/path/to/tuisic/build/tuisic", "--mcp-server"],
"enabled": true
}
DEMOS
- Screenshots: here scroll way down.
- Visualizer:
https://github.com/user-attachments/assets/1f512307-7c70-466d-9cd0-529e195871d0
- MCP Server:
https://github.com/user-attachments/assets/7601312a-9bca-4970-90a3-4a917fbe2fda
- Discord Rich Presence:
Thanks to all.
Contribution
It's open for contribution, read CONTRIBUTING.md for more information.
Tuisic MCP Fragen
Wie konfiguriere ich den Tuisic MCP server in meinem AI-Client?
Führe die tuisic-Binary mit dem Flag --mcp-server aus und füge sie als lokalen Befehl in deiner Client-Config hinzu.
Welche Musikquellen kann Tuisic durchsuchen?
Tuisic ruft Songs von JioSaavn, SoundCloud, LastFM, ForestFM und YouTube ab; YouTube Music ist in Planung.
Unterstützt Tuisic das Abspielen lokaler Musikdateien?
Ja, wenn du Local Music auswählst, scannt das Tool rekursiv den konfigurierten local_music.path und spielt die Dateien über mpv ab.
Wie installiere ich Tuisic auf Arch Linux?
Installiere das tuisic-git Paket aus dem AUR mit yay oder baue es aus dem Quellcode mit den aufgeführten Dependencies.
Welche Tastenkombinationen hat Tuisic?
Es nutzt Vim-Style Motions: q beendet das Programm, w schaltet den Daemon-Modus um, Space spielt ab oder pausiert, und > sowie < überspringen Tracks.