> 📘 **完整指南**：[在 Gemini CLI 中使用 AceData Cloud 所有 MCP →](https://platform.acedata.cloud/documents/promotion_article_mcp_all_gemini_cli?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)

在现代开发场景中，**Ace Data Cloud** 提供了一套高效的多模态计算平台（MCP，Model Context Protocol），支持文本、语音、图像等模型的调用。Fish Audio 是其高保真 TTS（文本转语音）服务，支持选择音色、采样率和格式，涵盖 s1 / s2-pro 模型。通过 Gemini CLI 集成 Fish Voice MCP 后，你可以直接在命令行或对话中调用语音合成功能，无需频繁切换窗口或复制粘贴，提高开发和测试效率。

---

## 环境准备 / 前置条件

1. 已安装 **Gemini CLI**（[官方文档](https://platform.acedata.cloud/documents/promotion_article_mcp_all_gemini_cli?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)）。
2. 已注册 **AceData Cloud** 账户：[注册入口](https://platform.acedata.cloud/?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)。
3. 获取 API Token，用于鉴权调用 MCP 服务。
4. 熟悉命令行操作和基本 JSON 编辑。

---

## 第一步：获取 API Token

1. 打开 [AceData Cloud 平台](https://platform.acedata.cloud/?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)。
2. 登录账户后，在首页复制 **API Token**。
3. 一个 Token 可用于访问所有 AceData Cloud MCP 服务。
4. 如需详细步骤，可参考官方完整指南：[完整指南 →](https://platform.acedata.cloud/documents/promotion_article_mcp_all_gemini_cli?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)。

---

## 第二步：配置 Fish Voice MCP

### 方式一：命令行一键添加（推荐）

```bash
gemini mcp add fish \
  --type http \
  --url https://fish.mcp.acedata.cloud/mcp \
  --header "Authorization: Bearer yourToken"
```

### 方式二：手动编辑配置文件

编辑 `~/.gemini/settings.json`，添加 MCP 配置：

```json
{
  "mcpServers": {
    "fish": {
      "httpUrl": "https://fish.mcp.acedata.cloud/mcp",
      "headers": { "Authorization": "Bearer yourToken" }
    }
  }
}
```

> ⚡ 配置完成后，下次启动 Gemini CLI 即可使用 Fish Voice 工具。

---

## 第三步：使用示例

Fish Voice MCP 提供 `fish_generate_audio` 工具，可进行多语言文本合成，支持选择模型、音色、采样率、格式及延迟模式。

```bash
# 合成中文文本为 mp3（默认音色）
fish_generate_audio "你好，欢迎使用 Fish Voice MCP" --output hello.mp3

# 合成英文文本为 wav，采样率 44100Hz，使用指定音色
fish_generate_audio "Hello world!" --format wav --sample-rate 44100 --voice-id xxxx --output hello.wav

# 合成播客脚本为 mp3，码率 128kbps，低延迟模式
fish_generate_audio "今天的播客内容是..." --format mp3 --bitrate 128 --low-latency --output podcast.mp3
```

### 工具功能概览

| 工具                | 功能说明                                                                                  |
|---------------------|--------------------------------------------------------------------------------------------|
| fish_generate_audio  | 文本转语音，支持 s1 / s2-pro 模型，音色、采样率、格式和延迟模式可选                         |

---

## 常见问题

1. **Token 无法生效**  
   - 确认是否复制完整 Token。  
   - 确认 JSON 配置格式正确，避免多余逗号或引号错误。

2. **生成音频不播放或报错**  
   - 检查输出文件格式与播放器兼容性。  
   - 确认网络连接正常，并能访问 `https://fish.mcp.acedata.cloud/mcp`。

3. **想切换模型或音色**  
   - 参考命令行参数 `--voice-id` 或 `--model`，可自由选择 s1 / s2-pro。

---

## 总结

通过 Gemini CLI 集成 Fish Voice MCP，你可以在命令行中快速完成文本转语音操作，无需跳转窗口，极大提高开发与测试效率。结合 Ace Data Cloud 的 MCP 服务，你还可以扩展更多 AI 模型能力，如图像生成、数据分析等。对于初中级开发者，这是一套即学即用的高效工具链。

---

## 相关链接

- [Fish Audio MCP Server (GitHub)](https://github.com/AceDataCloud/FishMCP)  
- [Fish Audio MCP on PyPI](https://pypi.org/project/mcp-fish/)  
- [AceData Cloud 平台](https://platform.acedata.cloud/?inviter_id=bfb12a50-1564-46e6-822d-44413472a55b)  

---

### 标签

`#AceDataCloud` `#GeminiCLI` `#TTS` `#MCP` `#开发教程`