Tuisic MCP server
2026년 9월 16일 커밋MCP를 통해 터미널 TUI에서 온라인 음악 스트리밍을 검색, 재생 및 관리할 수 있습니다.
다른 이름 Dark-Kernel/tuisic
- 스타
- 76
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 9월 16일
- 라이선스
- GPL-3.0
Tuisic MCP란?
Tuisic은(는) MCP server입니다. MCP를 통해 터미널 TUI에서 온라인 음악 스트리밍을 검색, 재생 및 관리할 수 있습니다.
프로젝트 README에서 생성된 요약
Tuisic MCP server 정보
tuisic을 사용하면 터미널 인터페이스를 통해 음악을 관리하고 재생할 수 있습니다. 이 도구는 사용자가 Vim 모션을 사용하여 명령줄 인터페이스에서 직접 곡을 검색하고 스트리밍 재생을 제어할 수 있게 합니다. tuisic --mcp-server 명령어를 통해 AI 클라이언트에 연결되는 로컬 MCP server로 작동하며, AI가 사용자의 음악 라이브러리 및 온라인 소스와 상호작용할 수 있도록 지원합니다.
사용자는 SoundCloud, YouTube, JioSaavn, LastFM을 포함한 다양한 플랫폼의 음악에 접근할 수 있습니다. 또한 서버는 기본값인 ~/Music 경로와 같이 설정된 디렉토리를 스캔하여 로컬 음악 파일을 처리하고 mpv를 통해 재생합니다. 단순한 재생을 넘어 플레이리스트 관리, 곡 다운로드, 즐겨찾기 목록과 같은 기능을 지원합니다. MPRIS 지원을 위해 playerctl과 같은 시스템 도구와 통합되며, 재생 중에 가사를 표시하거나 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 | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능dark-kernel/tuisic is public and reachablegithub.com/dark-kernel/tuisic ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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
GitHub에서 보기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 질문
AI 클라이언트에서 Tuisic MCP server를 어떻게 설정하나요?
--mcp-server 플래그와 함께 tuisic 바이너리를 실행하고 클라이언트 설정에 로컬 명령어로 추가합니다.
Tuisic은 어떤 음악 소스를 검색할 수 있나요?
Tuisic은 JioSaavn, SoundCloud, LastFM, ForestFM, YouTube에서 곡을 가져오며, 향후 YouTube Music 지원이 예정되어 있습니다.
Tuisic이 로컬 음악 파일 재생을 지원하나요?
네, Local Music을 선택하면 설정된 local_music.path를 재귀적으로 스캔하여 mpv를 통해 파일을 재생합니다.
Arch Linux에서 Tuisic을 어떻게 설치하나요?
yay를 사용하여 AUR에서 tuisic-git 패키지를 설치하거나, 나열된 종속성을 사용하여 소스에서 빌드합니다.
Tuisic의 키보드 단축키는 무엇인가요?
Vim 스타일 모션을 사용합니다: q는 종료, w는 데몬 모드 전환, space는 재생/일시정지, > 및 <는 트랙 건너뛰기입니다.