mcpField
R
RetellAI MCP Server

RetellAI MCP Server

本地服务
npmjs.com通信协作4029 周前更新

关于 RetellAI MCP Server

RetellAI MCP Server 是面向 RetellAI 语音服务的 MCP 服务,允许 AI 助手管理通话、语音 Agent、电话号码和语音选项。适合需要通过 MCP 客户端配置或调用 RetellAI 语音能力的用户。

主要功能

  1. 01通话的创建、查询与删除
  2. 02语音 Agent 的创建与更新
  3. 03电话号码的查看与配置
  4. 04可用语音选项的查询

适用场景

  1. 01列出账户中的电话号码和语音 Agent
  2. 02创建外呼电话或网页通话
  3. 03为语音 Agent 配置不同的 LLM 设置

MCP 相关

该项目是一个 MCP 服务,向 MCP 客户端暴露 RetellAI 的通话、Agent、电话号码和语音相关工具,使 AI 助手可以操作 RetellAI 服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"retellai": {
"command": "npx",
"args": [
"-y",
"@abhaybabbar/retellai-mcp-server"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>"
}
}
}
}
启动命令npx -y @abhaybabbar/retellai-mcp-server
需要配置的环境变量
RETELL_API_KEY密钥

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@abhaybabbar/retellai-mcp-server

工具

24

收录的工具列表 · 更新于 3 周前

参数类型必填说明
metadataobject否
toNumberstring是要拨打的电话号码
directionenum否inbound | outbound
fromNumberstring是用于拨打的电话号码
optInSignedUrlboolean否
overrideAgentIdstring否对于此次呼叫,使用此 Agent ID 覆盖所用的 Agent
overrideAgentVersionnumber否对于此次呼叫,使用此版本覆盖所用的 Agent 版本
retellLlmDynamicVariablesobject否以键值对形式传递给 LLM 的动态变量
optOutSensitiveDataStorageboolean否

详细介绍

RetellAI MCP 服务

这是一个适用于 RetellAI 的模型上下文协议(MCP)服务实现,可让 AI 助手与 RetellAI 的语音服务交互。

功能

RetellAI MCP 服务提供以下工具:

  • 通话管理:创建和管理电话通话及网页通话
  • Agent 管理:使用不同的大模型配置创建和管理语音 Agent
  • 电话号码管理:配置和管理电话号码
  • 语音管理:访问和使用不同的语音选项

Claude Desktop 设置

  1. 打开 Claude Desktop,然后按 CMD + , 前往 Settings。
  2. 点击 Developer 选项卡。
  3. 点击 Edit Config 按钮。
  4. 文件资源管理器中会打开 claude_desktop_config.json 文件。
  5. 从 Retell 控制面板获取 Retell API 密钥(https://dashboard.retellai.com/apiKey)。
  6. 将以下内容添加到 claude_desktop_config.json 文件中。更多详情请参阅此处。
  7. 编辑配置文件后,重启 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

此问题通常由较旧安装中的依赖项/版本不匹配导致。

示例用例:

  1. 列出我在 retellai 中的所有号码
  2. 列出我的所有 Agent
  3. 详细介绍一下披萨配送 Agent
  4. 创建 Agent 并拨打电话的示例:
    1. 创建一个 Agent,让它致电我当地的披萨店,确保对话简短明了。
    2. 点一份玛格丽特披萨
    3. 货到付款
    4. 将披萨送到
    5. Agent 应该假装是我。我叫 <your_name>
    6. 使用美国号码,拨打 <phone_number>,致电我当地的披萨店

仓库设置

  1. 安装依赖项:

    npm i
    
  2. 创建一个 .env 文件,并填入你的 RetellAI API 密钥:

    RETELL_API_KEY=your_api_key_here
    
  3. 运行服务:

    node src/retell/index.js
    

可用工具

通话工具
  • list_calls:列出所有 Retell 通话
  • create_phone_call:创建新的电话通话
  • create_web_call:创建新的网页通话
  • get_call:获取特定通话的详细信息
  • delete_call:删除特定通话
Agent 工具
  • list_agents:列出所有 Retell Agent
  • create_agent:创建新的 Retell Agent
  • get_agent:通过 ID 获取 Retell Agent
  • update_agent:更新现有 Retell Agent
  • delete_agent:删除 Retell Agent
  • get_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

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。