Tuisic MCP sunucusu
Commit 16 Eyl 2026Bir AI istemcisinin MCP aracılığıyla terminal TUI üzerinden çevrimiçi müzik akışını aramasını, çalmasını ve yönetmesini sağlar.
Ayrıca bilinen adı Dark-Kernel/tuisic
- Yıldızlar
- 76
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 16 Eyl 2026
- Lisans
- GPL-3.0
Tuisic MCP nedir?
Tuisic bir MCP sunucusudur. Bir AI istemcisinin MCP aracılığıyla terminal TUI üzerinden çevrimiçi müzik akışını aramasını, çalmasını ve yönetmesini sağlar.
Özet, projenin README dosyasından oluşturuldu
Tuisic MCP sunucusu hakkında
Müzik yönetimi ve çalma işlemleri, tuisic aracılığıyla bir terminal arayüzü üzerinden gerçekleştirilebilir. Bu araç, kullanıcıların Vim hareketlerini kullanarak doğrudan bir komut satırı arayüzünden şarkı aramasına ve akış oynatımını kontrol etmesine olanak tanır. tuisic --mcp-server komutu aracılığıyla AI istemcilerine bağlanan yerel bir MCP server olarak çalışır ve bir yapay zekanın müzik kütüphanenizle ve çevrimiçi kaynaklarla etkileşime girmesini sağlar.
Kullanıcılar SoundCloud, YouTube, JioSaavn ve LastFM dahil olmak üzere çeşitli platformlardan müziğe erişebilirler. Sunucu ayrıca, varsayılan ~/Music yolu gibi yapılandırılmış bir dizini tarayarak yerel müzik dosyalarını yönetir ve bunları mpv üzerinden çalar. Basit oynatmanın ötesinde; çalma listesi yönetimi, şarkı indirme ve favori listesi gibi özellikleri destekler. MPRIS desteği için playerctl gibi sistem araçlarıyla entegre çalışır ve oynatma sırasında şarkı sözlerini görüntüleyebilir veya bir Cava görselleştiricisi kullanabilir.
Neler yapabilirsiniz
- 1Çevrimiçi müzik arama ve çalmaAI istemcinizden SoundCloud veya YouTube üzerinden belirli bir şarkıyı bulmasını ve çalmaya başlamasını isteyin.
- 2Yerel müzik kütüphanelerini yönetmeAI'ya yerel müzik klasörünüzü taramasını ve kişisel koleksiyonunuzdaki dosyaları çalmasını söyleyin.
- 3Çevrimdışı kullanım için şarkı indirmeAI asistanınızdan o an dinlediğiniz bir parçayı indirmesini isteyin.
- 4Favori müzikleri organize etmeAI'ya mevcut parçayı favori şarkılar listenize eklemesini söyleyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Yapılandırma
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Ad | Açıklama | Sunucu |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirdark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
TUISIC
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 soruları
Tuisic MCP server'ını AI istemcimde nasıl yapılandırırım?
tuisic binary dosyasını --mcp-server bayrağı ile çalıştırın ve istemci yapılandırmanıza yerel bir komut olarak ekleyin.
Tuisic hangi müzik kaynaklarında arama yapabilir?
Tuisic; JioSaavn, SoundCloud, LastFM, ForestFM ve YouTube üzerinden şarkıları çeker; YouTube Music desteği planlanmaktadır.
Tuisic yerel müzik dosyalarını çalmayı destekliyor mu?
Evet, Local Music seçeneği yapılandırılmış local_music.path dizinini özyinelemeli olarak tarar ve dosyaları mpv üzerinden çalar.
Tuisic Arch Linux üzerine nasıl kurulur?
yay kullanarak AUR üzerinden tuisic-git paketini kurun veya listelenen bağımlılıklarla kaynak kodundan derleyin.
Tuisic hangi klavye kısayollarına sahiptir?
Vim tarzı hareketleri kullanır: q çıkış yapar, w daemon modunu açıp kapatır, space oynatır veya duraklatır, > ve < ise parçaları atlar.