Serveur MCP Tuisic
Commit 16 sept. 2026Permet à un client IA de rechercher, d'écouter et de gérer le streaming musical en ligne via une interface TUI dans le terminal grâce à MCP.
Aussi connu sous Dark-Kernel/tuisic
- Étoiles
- 76
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 16 sept. 2026
- Licence
- GPL-3.0
Qu'est-ce que Tuisic MCP ?
Permet à un client IA de rechercher, d'écouter et de gérer le streaming musical en ligne via une interface TUI dans le terminal grâce à MCP.
Résumé généré à partir du README du projet
À propos du MCP server Tuisic
La gestion et la lecture de musique via une interface terminal sont possibles grâce à tuisic. Cet outil permet aux utilisateurs de rechercher des morceaux et de contrôler la lecture en streaming directement depuis une interface en ligne de commande en utilisant les motions Vim. Il fonctionne comme un MCP server local qui se connecte aux clients IA via la commande tuisic --mcp-server, permettant ainsi à une IA d'interagir avec votre bibliothèque musicale et vos sources en ligne.
Les utilisateurs peuvent accéder à la musique de diverses plateformes, notamment SoundCloud, YouTube, JioSaavn et LastFM. Le serveur gère également les fichiers musicaux locaux en scannant un répertoire configuré, tel que le chemin par défaut ~/Music, et en les diffusant via mpv. Au-delà de la simple lecture, il prend en charge des fonctionnalités telles que la gestion de playlists, le téléchargement de chansons et une liste de favoris. Il s'intègre aux outils système comme playerctl pour le support MPRIS et peut afficher les paroles ou utiliser un visualiseur Cava pendant la lecture.
Ce que vous pouvez faire avec
- 1Rechercher et lire de la musique en ligneDemandez à votre client IA de trouver et de lancer la lecture d'une chanson spécifique sur SoundCloud ou YouTube.
- 2Gérer des bibliothèques musicales localesDonnez l'instruction à une IA de scanner votre dossier de musique local et de lire des fichiers issus de votre collection personnelle.
- 3Télécharger des chansons pour une utilisation hors ligneDemandez à votre assistant IA de télécharger un morceau que vous êtes en train d'écouter.
- 4Organiser ses favoris musicauxDites à l'IA d'ajouter le morceau actuel à votre liste de chansons favorites.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Nom | Description | Type |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibledark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubTUISIC
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.
Questions sur Tuisic MCP
Comment configurer le MCP server Tuisic dans mon client IA ?
Exécutez le binaire tuisic avec le flag --mcp-server et ajoutez-le comme commande locale dans la configuration de votre client.
Quelles sources musicales Tuisic peut-il rechercher ?
Tuisic récupère des morceaux depuis JioSaavn, SoundCloud, LastFM, ForestFM et YouTube, avec l'ajout de YouTube Music prévu prochainement.
Tuisic prend-il en charge la lecture de fichiers musicaux locaux ?
Oui, en sélectionnant Local Music, l'outil scanne récursivement le dossier configuré dans local_music.path et joue les fichiers via mpv.
Comment installer Tuisic sur Arch Linux ?
Installez le paquet tuisic-git depuis l'AUR avec yay, ou compilez-le à partir des sources avec les dépendances listées.
Quels sont les raccourcis clavier de Tuisic ?
Il utilise des commandes de type Vim : q pour quitter, w pour basculer le mode daemon, espace pour lire ou mettre en pause, et > et < pour passer au morceau suivant ou précédent.