关于 RetellAI MCP Server
RetellAI MCP Server 是面向 RetellAI 语音服务的 MCP 服务,允许 AI 助手管理通话、语音 Agent、电话号码和语音选项。适合需要通过 MCP 客户端配置或调用 RetellAI 语音能力的用户。
主要功能
- 01通话的创建、查询与删除
- 02语音 Agent 的创建与更新
- 03电话号码的查看与配置
- 04可用语音选项的查询
适用场景
- 01列出账户中的电话号码和语音 Agent
- 02创建外呼电话或网页通话
- 03为语音 Agent 配置不同的 LLM 设置
MCP 相关
该项目是一个 MCP 服务,向 MCP 客户端暴露 RetellAI 的通话、Agent、电话号码和语音相关工具,使 AI 助手可以操作 RetellAI 服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
24收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| metadata | object | 否 | |
| toNumber | string | 是 | 要拨打的电话号码 |
| direction | enum | 否 | inbound | outbound |
| fromNumber | string | 是 | 用于拨打的电话号码 |
| optInSignedUrl | boolean | 否 | |
| overrideAgentId | string | 否 | 对于此次呼叫,使用此 Agent ID 覆盖所用的 Agent |
| overrideAgentVersion | number | 否 | 对于此次呼叫,使用此版本覆盖所用的 Agent 版本 |
| retellLlmDynamicVariables | object | 否 | 以键值对形式传递给 LLM 的动态变量 |
| optOutSensitiveDataStorage | boolean | 否 |
详细介绍
RetellAI MCP 服务
这是一个适用于 RetellAI 的模型上下文协议(MCP)服务实现,可让 AI 助手与 RetellAI 的语音服务交互。
功能
RetellAI MCP 服务提供以下工具:
- 通话管理:创建和管理电话通话及网页通话
- Agent 管理:使用不同的大模型配置创建和管理语音 Agent
- 电话号码管理:配置和管理电话号码
- 语音管理:访问和使用不同的语音选项
Claude Desktop 设置
- 打开
Claude Desktop,然后按CMD + ,前往Settings。 - 点击
Developer选项卡。 - 点击
Edit Config按钮。 - 文件资源管理器中会打开
claude_desktop_config.json文件。 - 从 Retell 控制面板获取 Retell API 密钥(https://dashboard.retellai.com/apiKey)。
- 将以下内容添加到
claude_desktop_config.json文件中。更多详情请参阅此处。 - 编辑配置文件后,重启 Claude Desktop。
{
"mcpServers": {
"retellai-mcp-server": {
"command": "npx",
"args": ["-y", "@abhaybabbar/retellai-mcp-server"],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}
}
故障排除:“没有可用工具”
如果 Claude Desktop 能显示服务,但没有工具,请升级到最新的软件包版本:
npx -y @abhaybabbar/retellai-mcp-server@latest
此问题通常由较旧安装中的依赖项/版本不匹配导致。
示例用例:
- 列出我在 retellai 中的所有号码
- 列出我的所有 Agent
- 详细介绍一下披萨配送 Agent
- 创建 Agent 并拨打电话的示例:
- 创建一个 Agent,让它致电我当地的披萨店,确保对话简短明了。
- 点一份玛格丽特披萨
- 货到付款
- 将披萨送到
- Agent 应该假装是我。我叫 <your_name>
- 使用美国号码,拨打 <phone_number>,致电我当地的披萨店
仓库设置
-
安装依赖项:
npm i -
创建一个
.env文件,并填入你的 RetellAI API 密钥:RETELL_API_KEY=your_api_key_here -
运行服务:
node src/retell/index.js
可用工具
通话工具
list_calls:列出所有 Retell 通话create_phone_call:创建新的电话通话create_web_call:创建新的网页通话get_call:获取特定通话的详细信息delete_call:删除特定通话
Agent 工具
list_agents:列出所有 Retell Agentcreate_agent:创建新的 Retell Agentget_agent:通过 ID 获取 Retell Agentupdate_agent:更新现有 Retell Agentdelete_agent:删除 Retell Agentget_agent_versions:获取 Retell Agent 的所有版本
电话号码工具
list_phone_numbers:列出所有 Retell 电话号码create_phone_number:创建新的电话号码get_phone_number:获取特定电话号码的详细信息update_phone_number:更新电话号码delete_phone_number:删除电话号码
语音工具
list_voices:列出所有可用的 Retell 语音get_voice:获取特定语音的详细信息
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。