MCP server Tuisic
Коммит 16 сент. 2026 г.Позволяет AI-клиенту искать, проигрывать и управлять онлайн-стримингом музыки через терминальный TUI с помощью MCP.
Также известен как Dark-Kernel/tuisic
- Звёзды
- 76
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 16 сент. 2026 г.
- Лицензия
- GPL-3.0
Что такое Tuisic MCP?
Позволяет AI-клиенту искать, проигрывать и управлять онлайн-стримингом музыки через терминальный TUI с помощью MCP.
Сводка сгенерирована из README проекта
О Tuisic MCP server
Управлять музыкой и прослушивать её через терминальный интерфейс можно с помощью tuisic. Этот инструмент позволяет пользователям искать песни и управлять потоковым воспроизведением прямо из интерфейса командной строки, используя навигацию в стиле Vim. Он работает как локальный MCP server, который подключается к AI-клиентам через команду tuisic --mcp-server, позволяя AI взаимодействовать с вашей музыкальной библиотекой и онлайн-источниками.
Пользователи могут получать доступ к музыке с различных платформ, включая SoundCloud, YouTube, JioSaavn и LastFM. Сервер также работает с локальными музыкальными файлами, сканируя настроенную директорию (например, путь по умолчанию ~/Music) и воспроизводя их через mpv. Помимо простого воспроизведения, инструмент поддерживает такие функции, как управление плейлистами, скачивание песен и список избранного. Он интегрируется с системными утилитами вроде playerctl для поддержки MPRIS и может отображать тексты песен или использовать визуализатор Cava во время проигрывания.
Что вы можете с ним делать
- 1Поиск и воспроизведение онлайн-музыкиПопросите свой AI-клиент найти и запустить конкретную песню из SoundCloud или YouTube.
- 2Управление локальными музыкальными библиотекамиДайте команду AI просканировать вашу папку с музыкой и воспроизвести файлы из вашей личной коллекции.
- 3Скачивание песен для офлайн-прослушиванияПопросите своего AI-ассистента скачать трек, который вы слушаете в данный момент.
- 4Организация списка избранногоСкажите AI добавить текущий трек в ваш список любимых песен.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Конфигурация
BREW_PREFIXCMAKE_PREFIX_PATHHOMEBREW_PREFIXPKG_CONFIG_PATH
| Название | Описание | Тип |
|---|---|---|
| BREW_PREFIX | — | |
| CMAKE_PREFIX_PATH | — | |
| HOMEBREW_PREFIX | — | |
| PKG_CONFIG_PATH | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийdark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-09-16github.com/dark-kernel/tuisic ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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.
Вопросы о Tuisic MCP
Как настроить Tuisic MCP server в моем AI-клиенте?
Запустите бинарный файл tuisic с флагом --mcp-server и добавьте его как локальную команду в конфигурации вашего клиента.
Какие музыкальные источники может искать Tuisic?
Tuisic подтягивает песни из JioSaavn, SoundCloud, LastFM, ForestFM и YouTube; поддержка YouTube Music планируется.
Поддерживает ли Tuisic воспроизведение локальных музыкальных файлов?
Да, при выборе Local Music инструмент рекурсивно сканирует путь, указанный в local_music.path, и воспроизводит файлы через mpv.
Как установить Tuisic на Arch Linux?
Установите пакет tuisic-git из AUR с помощью yay или соберите из исходников, используя перечисленные зависимости.
Какие горячие клавиши есть в Tuisic?
Используются движения в стиле vim: q — выход, w — переключение режима демона, space — воспроизведение или пауза, а > и < — переключение треков.