项目简介:

Telnyx MCP 服务器是 Telnyx 官方提供的本地 MCP (Model Context Protocol) 服务器实现。它允许支持 MCP 协议的 LLM 客户端（如 Claude Desktop 等）通过标准化的方式访问和调用 Telnyx 的电话、短信、AI 助理等通信 API 功能。

主要功能点:

AI 助理管理: 创建、列出、获取、更新、删除 AI 助理，获取助理的 TeXML 配置，使用助理发起电话呼叫。
呼叫控制: 发起电话呼叫、挂断、转接、播放音频、发送 DTMF 信号、文本转语音。
消息发送: 发送短信/彩信、获取消息详情。
电话号码管理: 列出你的电话号码、购买新号码、更新号码配置、列出可用号码，更新号码的消息设置。
连接管理: 列出语音连接、获取连接详情、更新连接配置（注意：Telnyx API 不直接支持连接更新，此功能可能受限）。
云存储: 创建、列出存储桶，上传、下载、列出、删除存储桶中的文件，获取存储桶区域信息。
向量嵌入: 列出嵌入存储桶、抓取并嵌入网页 URL、为文件创建嵌入。
Secrets Manager: 列出、创建、删除集成密钥。
消息配置文件管理: 列出、创建、获取、更新消息配置文件。

安装步骤:

获取你的 Telnyx API 密钥，访问 Telnyx Portal。
安装 Python 包管理器 'uvx' (或 'uv')。你可以使用以下命令安装：
- Linux/macOS: 'curl -LsSf https://astral.sh/uv/install.sh | sh'
- macOS (Homebrew): 'brew install uv'
- 其他安装方法请参考 'uv' 仓库。
在支持 MCP 的 LLM 客户端（例如 Claude Desktop）的设置中，找到开发者或高级配置选项（如 Claude Desktop 中的 "Settings > Developer > Edit Config > claude_desktop_config.json"）。
添加 Telnyx MCP 服务器的配置到相应的 MCP 服务器列表中。

服务器配置:

MCP 服务器由兼容的 LLM 客户端通过运行指定的命令来启动。以下是 Claude Desktop 客户端中 'claude_desktop_config.json' 的一个配置示例：

要通过 Git 仓库直接运行：

{
  "mcpServers": {
    "Telnyx": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/team-telnyx/telnyx-mcp-server.git", "telnyx-mcp-server"],
      "env": {
        "TELNYX_API_KEY": "<你的 Telnyx API 密钥>"
      }
    }
  }
}

要通过本地克隆的仓库运行：

首先克隆仓库：'git clone https://github.com/team-telnyx/telnyx-mcp-server.git'

更新你的客户端配置，将 '--from' 指向本地路径：

{
  "mcpServers": {
    "Telnyx": {
      "command": "uvx",
      "args": ["--from", "/path/to/telnyx-mcp-server", "telnyx-mcp-server"],
      "env": {
        "TELNYX_API_KEY": "<你的 Telnyx API 密钥>"
      }
    }
  }
}

请将 '<你的 Telnyx API 密钥>' 替换为你的实际密钥。如果你使用的是本地仓库，请将 '/path/to/telnyx-mcp-server' 替换为你克隆仓库的绝对路径。如果你使用的是 Windows 版本的 Claude Desktop，可能需要先启用“开发者模式”（Help > Enable Developer Mode）。

基本使用方法:

配置完成后，重新启动你的 LLM 客户端。客户端会根据配置自动启动 Telnyx MCP 服务器。现在，你可以在与 LLM 客户端交流时，直接描述你希望执行的 Telnyx 操作。LLM 会理解你的意图，并利用 MCP 协议通过 Telnyx MCP 服务器调用相应的工具来为你完成任务。

例如，你可以尝试向 LLM 客户端提问：

"创建一个名为 '电商客服助理' 的 AI 代理，负责处理在线订单查询。"
"给电话号码 +15551234567 发送一条短信，内容是 '会议将在10分钟后开始。'"
"帮我在纽约寻找一个区号为 212 的可用电话号码。"
"上传我的合同文件 /Users/username/Documents/contract.pdf 到我的 'legal' 存储桶。"
"将我们公司网站的联系我们页面 [https://mycompany.com/contact] 嵌入到助理的知识库中。"

客户端与服务器之间的日志有助于调试，通常可以在客户端的日志目录找到，例如 Claude Desktop 的日志路径：

Windows: '%APPDATA%\Claude\logs\mcp-server-telnyx.log'
macOS: '~/Library/Logs/Claude/mcp-server-telnyx.log'

关键词

信息