Tuisic MCP server
Commit 16 Sep 2026Memungkinkan AI client untuk mencari, memutar, dan mengelola streaming musik online melalui terminal TUI via MCP.
Juga dikenal sebagai Dark-Kernel/tuisic
- Stars
- 76
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 16 Sep 2026
- Lisensi
- GPL-3.0
Apa itu Tuisic MCP?
Tuisic adalah MCP server. Memungkinkan AI client untuk mencari, memutar, dan mengelola streaming musik online melalui terminal TUI via MCP.
Ringkasan dibuat dari README proyek
Tentang Tuisic MCP server
Mengelola dan memutar musik melalui antarmuka terminal kini dimungkinkan dengan tuisic. Tool ini memungkinkan pengguna untuk mencari lagu dan mengontrol playback streaming secara langsung dari command line interface menggunakan Vim motions. Tuisic berfungsi sebagai local MCP server yang terhubung ke AI client melalui command tuisic --mcp-server, sehingga memungkinkan AI untuk berinteraksi dengan library musik dan sumber online Anda.
Pengguna dapat mengakses musik dari berbagai platform termasuk SoundCloud, YouTube, JioSaavn, dan LastFM. Server ini juga menangani file musik lokal dengan memindai direktori yang dikonfigurasi, seperti path default ~/Music, dan memutarnya melalui mpv. Selain playback sederhana, tool ini mendukung fitur seperti manajemen playlist, download lagu, dan daftar favorit. Tuisic juga terintegrasi dengan system tools seperti playerctl untuk dukungan MPRIS dan dapat menampilkan lirik atau menggunakan visualizer Cava saat musik diputar.
Apa yang bisa Anda lakukan dengannya
- 1Cari dan putar musik onlineMinta AI client Anda untuk menemukan dan mulai memutar lagu spesifik dari SoundCloud atau YouTube.
- 2Kelola library musik lokalInstruksikan AI untuk memindai folder musik lokal Anda dan memutar file dari koleksi pribadi Anda.
- 3Download lagu untuk penggunaan offlineMinta AI assistant Anda untuk mendownload track yang sedang Anda dengarkan.
- 4Organisir musik favoritBeritahu AI untuk menambahkan track yang sedang diputar ke dalam daftar lagu favorit Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Konfigurasi
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Nama | Deskripsi | Tipe |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaudark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang Tuisic MCP
Bagaimana cara mengonfigurasi Tuisic MCP server di AI client saya?
Jalankan binary tuisic dengan flag --mcp-server dan tambahkan sebagai local command di config client Anda.
Sumber musik apa saja yang bisa dicari oleh Tuisic?
Tuisic mengambil lagu dari JioSaavn, SoundCloud, LastFM, ForestFM, dan YouTube, dengan rencana penambahan YouTube Music ke depannya.
Apakah Tuisic mendukung pemutaran file musik lokal?
Ya, dengan memilih Local Music, tool ini akan memindai local_music.path yang telah dikonfigurasi secara rekursif dan memutar file melalui mpv.
Bagaimana cara menginstal Tuisic di Arch Linux?
Instal package tuisic-git dari AUR menggunakan yay, atau build dari source dengan dependencies yang telah terdaftar.
Shortcut keyboard apa saja yang tersedia di Tuisic?
Tuisic menggunakan vim-style motions: q untuk keluar, w untuk toggle daemon mode, space untuk play atau pause, serta > dan < untuk skip track.