io.github.AceDataCloud/mcp-fish

Official

by AceDataCloud · Python

MCP server exposing the AceDataCloud Fish Audio API (text-to-speech with voice conditioning)

Text-to-speech service with voice conditioning via AceDataCloud Fish Audio API.

README.md1 KBView on GitHub

MCP Fish Server

A Model Context Protocol (MCP) server for Fish Audio TTS (Text-to-Speech) via the AceDataCloud platform. Generate natural-sounding speech and explore the Fish voice model library.

Features

High-quality TTS: Generate speech from text via Fish Audio models
Voice library: Browse, search, and fetch metadata for Fish voice models
Asynchronous tasks: Submit generation tasks and poll for results
Batch task lookup: Query multiple task results in one call

Installation

bash

pip install mcp-fish

Configuration

Set your AceDataCloud API token:

bash

export ACEDATACLOUD_API_TOKEN=your_token_here

Get your token from https://platform.acedata.cloud.

Usage

stdio mode (default)

bash

mcp-fish

HTTP mode

bash

mcp-fish --transport http --port 8000

Tool Reference

Tool	Description
`fish_generate_audio`	Generate speech from text via a Fish voice model
`fish_list_models`	List available Fish voice models
`fish_get_model`	Fetch metadata for a specific Fish voice model
`fish_get_task`	Get the status / result of a generation task
`fish_get_tasks_batch`	Batch-fetch the status / result of multiple tasks
`fish_get_usage_guide`	Get the API usage guide

License

MIT — see LICENSE at the repository root.

Install

Configuration

Environment variables

ACEDATACLOUD_API_TOKENrequiredsecret

API token from Ace Data Cloud (https://platform.acedata.cloud)

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-fish": {
      "command": "uvx",
      "args": [
        "mcp-fish"
      ],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "<YOUR_ACEDATACLOUD_API_TOKEN>"
      }
    }
  }
}