内容
# Brainiall 语音 AI - MCP 服务器
MCP 服务器提供由 AI 驱动的发音评估、语音转文本和文本转语音工具，详见 [Brainiall](https://brainiall.com) 语音 AI API 文档。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `assess_pronunciation` | 评估说话者对给定文本的发音准确度（0-100），提供逐词和音素级别的反馈 |
| `transcribe_speech` | 将语音音频转录为文本，自动检测语言 |
| `synthesize_speech` | 将文本转换为自然流畅的语音音频（MP3） |
| `list_voices` | 列出所有可用的文本转语音声音 |
## 前置条件
在 **[app.brainiall.com](https://app.brainiall.com)** 获取您的免费 API 密钥。
## 安装
### 使用 pip
```bash
pip install fastmcp httpx
```
### 使用 Docker
```bash
docker build -t brainiall-mcp .
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcp
```
## 配置
设置 `BRAINIALL_API_KEY` 环境变量：
```bash
export BRAINIALL_API_KEY=your-api-key
```
### Claude 桌面版
添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}
```
### Cursor / VS Code
添加到您的 MCP 设置：
```json
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "/path/to/server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}
```
### 流式 HTTP（Docker / 远程）
```bash
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcp
```
将您的 MCP 客户端连接到 `http://localhost:8000/mcp`。
## 本地运行
```bash
# 标准输入输出（Claude Desktop / Cursor 默认）
BRAINIALL_API_KEY=your-key fastmcp run server.py
# 流式 HTTP
BRAINIALL_API_KEY=your-key fastmcp run server.py --transport streamable-http --port 8000
```
## API 参考
所有工具都与 `https://api.brainiall.com` 处的 Brainiall 语音 AI API 通信。完整 API 文档可在 [app.brainiall.com](https://app.brainiall.com) 获取。
### assess_pronunciation
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `text` | 字符串 | 是 | 用户应该朗读的参考文本 |
| `audio_base64` | 字符串 | 是 | Base64 编码的音频（WAV 或 MP3） |
| `language` | 字符串 | 否 | 语言代码，默认为 `zh-CN` |
### transcribe_speech
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `audio_base64` | 字符串 | 是 | Base64 编码的音频（WAV、MP3、WEBM、OGG） |
| `language` | 字符串 | 否 | 转录的语言提示 |
### synthesize_speech
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `text` | 字符串 | 是 | 要转换为语音的文本 |
| `voice` | 字符串 | 否 | 语音 ID，默认为 `alloy` |
| `speed` | 浮点数 | 否 | 速度乘数（0.5-2.0），默认为 `1.0` |
### list_voices
无参数。返回可用语音选项及其 ID 和支持的语言。
## 许可证
MIT
## 链接
- [Brainiall](https://brainiall.com) - AI 模型提供商
- [获取 API 密钥](https://app.brainiall.com) - 注册并获取您的免费 API 密钥
