使用说明
Brainiall语音AI-MCP服务器
MCP服务器通过以下方式提供人工智能语音评估、语音转文本和文本转语音工具 Brainiall 语音AI API。
工具
| 工具 | 说明 |
|---|---|
assess_pronunciation |
根据每个单词和音素级别的反馈,对说话者发音的准确度(0-100)进行评分 |
transcribe_speech |
通过自动语言检测将语音音频转录为文本 |
synthesize_speech |
将文本转换为听起来自然的语音音频(MP3) |
list_voices |
列出所有可用的文本转语音 |
先决条件
在获取免费API密钥 app.brainiall.com.
安装
使用pip
pip install fastmcp httpx
使用Docker
docker build -t brainiall-mcp .
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcp
配置
设置 BRAINIALL_API_KEY 环境变量:
export BRAINIALL_API_KEY=your-api-key
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}
光标/VS代码
添加到MCP设置中:
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "/path/to/server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}
流式HTTP(Docker/Remote)
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcp
将您的MCP客户端连接到 http://localhost:8000/mcp.
本地运行
# stdio (default for Claude Desktop / Cursor)
BRAINIALL_API_KEY=your-key fastmcp run server.py
# streamable-http
BRAINIALL_API_KEY=your-key fastmcp run server.py --transport streamable-http --port 8000
API 参考
所有工具都可以通过 https://api.brainiall.com.API完整文档可在 app.brainiall.com.
评估_通知
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
text |
string | 是 | 用户应该阅读的引用文本 |
audio_base64 |
string | 是 | Base64编码音频(WAV或MP3) |
language |
string | 否 | 语言代码,默认值 en-US |
转录_语音
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
audio_base64 |
string | 是 | Base64编码音频(WAV、MP3、WEBM、OGG) |
language |
string | 否 | 转录语言提示 |
合成演讲
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
text |
string | 是 | 要转换为语音的文本 |
voice |
string | 否 | 语音ID,默认值 alloy |
speed |
float | 否 | 速度倍数(0.5-2.0),默认值 1.0 |
list_voices
没有参数。返回带有ID和支持语言的可用语音选项。
许可证
麻省理工学院