Tuisic
First of its kind, A simple TUI online music streaming application written in c++ with easy vim motions, now with support for Model Context Protocol (MCP)
What is Tuisic?
Tuisic is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to first of its kind, a simple tui online music streaming application written in c++ with easy vim motions, now with support for model context protocol (mcp)
First of its kind, A simple TUI online music streaming application written in c++ with easy vim motions, now with support for Model Context Protocol (MCP)
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- First of its kind, A simple TUI online music streaming appli
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx tuisicConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Tuisic
Tuisic is a terminal-based music streaming application written in C++ that integrates with streaming sources such as JioSaavn, SoundCloud, LastFM, and YouTube, and now includes experimental Model Context Protocol (MCP) support so AI assistants can control playback. Users navigate with vim-style keybindings, manage playlists and favorites, and optionally share their listening status via Discord Rich Presence or MPRIS D-Bus. The MCP integration lets AI clients start, stop, and query the player through a local stdio server launched with the --mcp-server flag.
Prerequisites
- Linux (Arch AUR package available) or macOS (build from source with Homebrew dependencies)
- Build tools: cmake, pkg-config, and a C++ compiler supporting C++17
- System libraries: mpv, curl, fftw, fmt, rapidjson (and optionally sdbus-cpp for MPRIS)
- An MCP-compatible AI client such as Claude Desktop or opencode
Install system dependencies
On Arch Linux install with pacman; on Debian/Ubuntu use apt-get; on macOS use Homebrew. The key libraries are mpv (audio), curl (network), fftw (visualizer), fmt, and rapidjson.
# Arch Linux
sudo pacman -S curl mpv fmt yt-dlp fftw sdbus-cpp rapidjson
# Debian/Ubuntu
sudo apt-get install build-essential cmake pkg-config libfftw3-dev libmpv-dev libcurl4-openssl-dev libfmt-dev libsystemd-dev rapidjson-dev libpulse-dev
# macOS
brew install cmake pkg-config fftw mpv curl fmt rapidjsonInstall via AUR (Arch Linux) or build from source
Arch Linux users can install the AUR package directly. All other platforms must build from source using cmake.
# Arch Linux (AUR)
yay -S tuisic-git
# Build from source (all platforms)
git clone https://github.com/Dark-Kernel/tuisic.git
cd tuisic
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release -j$(nproc)
sudo make installVerify the installation
Run tuisic in your terminal to confirm it starts correctly and can reach music sources.
tuisicStart tuisic in MCP server mode
Pass the --mcp-server flag to expose the MCP stdio interface. This mode is intended for AI client integration, not interactive use.
tuisic --mcp-serverConfigure your MCP client
Add tuisic as a local MCP server in your AI client's configuration file. Point the command to the compiled binary and pass the --mcp-server flag.
{
"mcpServers": {
"tuisic": {
"command": "/usr/local/bin/tuisic",
"args": ["--mcp-server"]
}
}
}Tuisic Examples
Client configuration
Example configuration for Claude Desktop or opencode. Replace the command path with the actual location of your tuisic binary (find it with 'which tuisic' or point to the build directory).
{
"mcpServers": {
"tuisic": {
"command": "/usr/local/bin/tuisic",
"args": ["--mcp-server"]
}
}
}Prompts to try
These prompts let an AI assistant control Tuisic playback through MCP.
- "Play some lo-fi hip-hop on Tuisic."
- "Pause the current track."
- "What song is playing right now?"
- "Add the current track to my favorites."Troubleshooting Tuisic
Build fails with missing mpv or libmpv header errors
Install the mpv development package for your distro (libmpv-dev on Debian/Ubuntu, mpv on Arch). On macOS run 'brew install mpv'. Confirm the header is visible with 'pkg-config --cflags mpv'.
MCP server mode exits immediately with no output
The --mcp-server flag uses stdio transport; any terminal output from the interactive UI conflicts with MCP messages. Make sure you are running the server from your AI client config rather than interactively, and that the path to the binary is correct.
No audio output during playback
Tuisic relies on mpv for audio. Check that mpv itself can play a file ('mpv <url>') and that your system audio (PulseAudio or PipeWire) is working. On Arch, install pulseaudio or pipewire-pulse if missing.
Frequently Asked Questions about Tuisic
What is Tuisic?
Tuisic is a Model Context Protocol (MCP) server that first of its kind, a simple tui online music streaming application written in c++ with easy vim motions, now with support for model context protocol (mcp) It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Tuisic?
Follow the installation instructions on the Tuisic GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Tuisic?
Tuisic works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Tuisic free to use?
Yes, Tuisic is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.
Tuisic Alternatives — Similar Communication Servers
Looking for alternatives to Tuisic? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Tuisic in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Tuisic?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.