Tuisic MCPサーバー
コミット 2026年9月16日MCPを介して、ターミナルのTUIからオンライン音楽ストリーミングの検索、再生、管理をAIクライアントに行わせます。
別名 Dark-Kernel/tuisic
- スター
- 76
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年9月16日
- ライセンス
- GPL-3.0
Tuisic MCPとは
TuisicはMCPサーバーです。 MCPを介して、ターミナルのTUIからオンライン音楽ストリーミングの検索、再生、管理をAIクライアントに行わせます。.
プロジェクトの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を設定するにはどうすればよいですか?
tuisic バイナリを --mcp-server フラグ付きで実行し、クライアントの設定にローカルコマンドとして追加してください。
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 で再生/一時停止、> および < で曲のスキップが可能です。