Cartesia MCP服务器
Cartesia MCP服务器公开 卡特尔 API在 模型上下文协议（MCP） 因此，客户如 光标, 克劳德桌面版，以及 OpenAI代理 可以列出声音，运行 文本转语音、克隆语音、填充音频等，无需一次性脚本。
文档： Cartesia文件——MCP （概述和返回此README的链接）。
需求
- Python 3.13+ （要求；强制执行
pyproject.toml) - A. Cartesia API密钥 --在下面创建一个 API密钥 在登录后 操场免费等级包括每月20000个学分。
安装
点
pip install cartesia-mcp
which cartesia-mcp # copy absolute path for MCP config below紫外线（建议用于短暂跑步）
如果你使用 紫外线，您可以在不进行全局安装的情况下运行已发布的软件包：
uvx cartesia-mcp使用 which uvx 或 command -v uvx 如果您的MCP客户端需要一个绝对路径 uvx一些客户端通过以下方式调用MCP command + args （参见 光标).
环境
| 变量 | 必填 | 描述 |
|---|---|---|
CARTESIA_API_KEY | 是 | 您的Cartesia API密钥 |
OUTPUT_DIRECTORY | 否 | 生成音频文件的目录（默认为 .) |
Claude桌面集成
编辑 设置→ 开发者→ 编辑配置 (claude_desktop_config.json).
使用 已安装的可执行文件 （从 pip install)或 uvx:
已安装 cartesia-mcp
{
"mcpServers": {
"cartesia-mcp": {
"command": "/absolute/path/to/cartesia-mcp",
"env": {
"CARTESIA_API_KEY": "",
"OUTPUT_DIRECTORY": "/absolute/path/to/output"
}
}
}
}省略 OUTPUT_DIRECTORY 将文件写入进程工作目录。
uvx
{
"mcpServers": {
"cartesia-mcp": {
"command": "uvx",
"args": ["cartesia-mcp"],
"env": {
"CARTESIA_API_KEY": ""
}
}
}
}试着让克劳德…
- 列出所有可用的Cartesia声音
- 使用所选语音将文本转换为音频
- 将现有语音本地化为另一种语言
- 在两个片段之间填充音频（提供音频文件的绝对路径）
- 更改音频文件以使用其他语音
光标集成
创建 .cursor/mcp.json 在您的项目或 ~/.cursor/mcp.json 全球地。您可以使用与以下相同的形状 克劳德桌面版 (command 指向已安装的二进制文件，或 uvx + args).
工具
服务器为TTS注册MCP工具(text_to_speech)，语音列表和管理(list_voices, get_voice, clone_voice等等）， 填充, 变声，以及 本地化语音。参见 cartesia_mcp/server.py 获取权威列表和参数。