MCP server de Tuisic
Commit 16 sept 2026Permite que un cliente de IA busque, reproduzca y gestione streaming de música online desde una TUI de terminal mediante MCP.
También conocido como Dark-Kernel/tuisic
- Stars
- 76
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 16 sept 2026
- Licencia
- GPL-3.0
¿Qué es Tuisic MCP?
Tuisic es un MCP server. Permite que un cliente de IA busque, reproduzca y gestione streaming de música online desde una TUI de terminal mediante MCP.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Tuisic
Gestionar y reproducir música a través de una interfaz de terminal es posible mediante tuisic. Esta herramienta permite a los usuarios buscar canciones y controlar la reproducción de streaming directamente desde una interfaz de línea de comandos usando movimientos de Vim. Funciona como un MCP server local que se conecta a clientes de IA mediante el comando tuisic --mcp-server, permitiendo que una IA interactúe con tu biblioteca musical y fuentes online.
Los usuarios pueden acceder a música de varias plataformas, incluyendo SoundCloud, YouTube, JioSaavn y LastFM. El servidor también gestiona archivos de música locales escaneando un directorio configurado, como la ruta predeterminada ~/Music, y los reproduce a través de mpv. Más allá de la simple reproducción, admite funciones como la gestión de listas de reproducción, la descarga de canciones y una lista de favoritos. Se integra con herramientas del sistema como playerctl para soporte MPRIS y puede mostrar letras o usar un visualizador Cava durante la reproducción.
Qué puedes hacer con él
- 1Buscar y reproducir música onlinePide a tu cliente de IA que busque y comience a reproducir una canción específica de SoundCloud o YouTube.
- 2Gestionar bibliotecas de música localesIndica a una IA que escanee tu carpeta de música local y reproduzca archivos de tu colección personal.
- 3Descargar canciones para uso offlineHaz que tu asistente de IA descargue una pista que estés escuchando en ese momento.
- 4Organizar canciones favoritasDile a la IA que añada la pista actual a tu lista de canciones favoritas.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Nombre | Descripción | Tipo |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibledark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre Tuisic MCP
¿Cómo configuro el MCP server de Tuisic en mi cliente de IA?
Ejecuta el binario de tuisic con el flag --mcp-server y añádelo como un comando local en la configuración de tu cliente.
¿Qué fuentes de música puede buscar Tuisic?
Tuisic obtiene canciones de JioSaavn, SoundCloud, LastFM, ForestFM y YouTube; el soporte para YouTube Music está planeado.
¿Soporta Tuisic la reproducción de archivos de música locales?
Sí, al seleccionar Local Music se escanea de forma recursiva el local_music.path configurado y se reproducen los archivos a través de mpv.
¿Cómo instalo Tuisic en Arch Linux?
Instala el paquete tuisic-git desde el AUR con yay, o compílalo desde el código fuente con las dependencias listadas.
¿Qué atajos de teclado tiene Tuisic?
Utiliza movimientos estilo vim: q para salir, w para alternar el modo daemon, espacio para reproducir o pausar, y > y < para saltar pistas.