da-okazaki/mcp-fish-audio-server

An MCP (Model Context Protocol) server that provides seamless integration between Fish Audio's Text-to-Speech API and LLMs like Claude, enabling natural language-driven speech synthesis.
## What is Fish Audio?
Fish Audio is a cutting-edge Text-to-Speech platform that offers:
🌊 State-of-the-art voice synthesis with natural-sounding output
🎯 Voice cloning capabilities to create custom voice models
🌍 Multilingual support including English, Japanese, Chinese, and more
⚡ Low-latency streaming for real-time applications
🎨 Fine-grained control over speech prosody and emotions
This MCP server brings Fish Audio's powerful capabilities directly to your LLM workflows.
## Features
🎙️ High-Quality TTS: Leverage Fish Audio's state-of-the-art TTS models
🌊 Streaming Support: Real-time audio streaming for low-latency applications
🎨 Multiple Voices: Support for custom voice models via reference IDs
🎯 Smart Voice Selection: Select voices by ID, name, or tags
📚 Voice Library Management: Configure and manage multiple voice references
🔧 Flexible Configuration: Environment variable-based configuration
📦 Multiple Audio Formats: Support for MP3, WAV, PCM, and Opus
🚀 Easy Integration: Simple setup with any MCP-compatible client
## Quick Start
### Installation
You can run this MCP server directly using npx:
bash
npx @alanse/fish-audio-mcp-server
Or install it globally:
bash
npm install -g @alanse/fish-audio-mcp-server
### Configuration
1. Get your Fish Audio API key from Fish Audio
2. Set up environment variables:
bash
export FISHAPIKEY=yourfishaudioapikeyhere
3. Add to your MCP settings configuration:
#### Single Voice Mode (Simple)
json
"mcpServers": {
"fish-audio": {
"command": "npx",
"args": ["-y", "@alanse/fish-audio-mcp-server"],
"env": {
"FISHAPIKEY": "yourfishaudioapikeyhere",
"FISHMODELID": "speech-1.6",
"FISHREFERENCEID": "yourvoicereferenceidhere",
"FISHOUTPUTFORMAT": "mp3",
"FISHSTREAMING": "false",
"FISHLATENCY": "balanced",
"FISHMP3BITRATE": "128",
"FISHAUTOPLAY": "false",
"AUDIOOUTPUTDIR": "~/.fish-audio-mcp/audiooutput"
#### Multiple Voice Mode (Advanced)
json
"mcpServers": {
"fish-audio": {
"command": "npx",
"args": ["-y", "@alanse/fish-audio-mcp-server"],
"env": {
"FISHAPIKEY": "yourfishaudioapikeyhere",
"FISHMODELID": "speech-1.6",
"FISHREFERENCES": "[{'referenceid':'id1','name':'Alice','tags':['female','english']},{'referenceid':'id2','name':'Bob','tags':['male','japanese']},{'referenceid':'id3','name':'Carol','tags':['female','japanese','anime']}]",
"FISHDEFAULTREFERENCE": "id1",
"FISHOUTPUTFORMAT": "mp3",
"FISHSTREAMING": "false",
"FISHLATENCY": "balanced",
"FISHMP3BITRATE": "128",
"FISHAUTOPLAY": "false",
"AUDIOOUTPUTDIR": "~/.fish-audio-mcp/audiooutput"
## Environment Variables
| Variable | Description | Default | Required |
| FISHAPIKEY | Your Fish Audio API key | - | Yes |
| FISHMODELID | TTS model to use (s1, speech-1.5, speech-1.6) | s1 | Optional |
| FISHREFERENCEID | Default voice reference ID (single reference mode) | - | Optional |
| FISHREFERENCES | Multiple voice references (see below) | - | Optional |
| FISHDEFAULTREFERENCE | Default reference ID when using multiple references | - | Optional |
| FISHOUTPUTFORMAT | Default audio format (mp3, wav, pcm, opus) | mp3 | Optional |