Telnyx MCP Server

官方

连接 IDE 与 Telnyx 远程 MCP 服务器的官方代理

分类: 其他第 119 / 230
Stars: ★ 221 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 7 天前

54FMRS · D

Telnyx MCP 是 Telnyx 官方维护的代理/入口，用于将 IDE 中的 AI 编码助手连接到其远程电信 API MCP 服务器，核心价值在于让代理无需预训练知识或脆弱的文档检索即可调用 Telnyx 服务；主要风险集中在 API 密钥安全与账户操作权限上，源材料未提供具体工具清单。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

8/20

维护活跃度

14/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: 清单仅包含包元数据(npm包@telnyx/mcp、stdio传输、一个必需的密钥环境变量),未列出具体工具清单,审阅材料中也没有测试套件或CI工作流证据,因此无法验证声明的工具与真实行为是否一致。该服务器被描述为指向Telnyx远程托管MCP端点的轻量代理,实际逻辑主要在服务器端执行,无法从本仓库验证。未见错误处理或故障模式的说明。根据静态评审上限,可靠性维度评分较低。
安全与权限 8/20: 凭证处理方式较为合理(TELNYX_API_KEY通过环境变量传递,明确标记为isSecret/isRequired,示例中未硬编码真实密钥)。但该服务器代理了对电信账户的完整API访问权限,而README中的Agent Toolkit示例已包含购买号码、发送短信、通过MPP/x402为账户充值、携号转网等具有实际付费或不可逆后果的操作。无论是清单还是README,均未披露MCP代理层面对此类操作的权限范围限制、工具白名单或确认机制——这是未披露的风险点而非已证实的红线行为,因此按扣分而非红线处理。同时也未说明请求数据在Telnyx远程基础设施中的留存或日志方式。
维护活跃度 14/20: 仓库处于活跃状态(未归档),采用MIT许可证,并列出了来自专门的'AI-FDE团队'的四位维护者,配有CODEOWNERS文件及用于漏洞报告的SECURITY.md渠道,体现了明确的所有权和安全响应路径。201星对应30个未解决issue,说明有真实使用但也有待处理积压。审阅材料中未见发布/版本历史、变更日志或依赖更新节奏的证据,因此无法确认持续维护的规律性。
文档质量 13/20: 根目录README结构分层,覆盖了多种安装路径(Claude Code插件、Gemini CLI扩展、Cursor配置、直接npx调用)并附有可直接复制的配置片段,同时链接到/tools/mcp、/skills、/guides等深入文档。但这些深入文档并未包含在审阅证据中,且README本身未列出MCP服务器实际的工具清单、参数、速率限制,也未说明工具包示例中隐含的电信操作(购买号码、发送短信等)可能产生的费用。针对MCP代理本身的故障排查说明也缺失。
安装易用性 12/20: 安装步骤较少且有具体示例:通过npx以--api-key参数调用,或在Cursor的mcp.json中配置托管HTTP端点,清单中必需的TELNYX_API_KEY也被正确标记为密钥。这表明在主流客户端中摩擦较低。但清单(声明stdio传输及基于environmentVariables的API密钥)与README中的CLI参数示例、以及另外的托管HTTP示例之间存在轻微不一致,难以判断对于io.github.team-telnyx/telnyx-mcp哪种方式才是权威配置方式。本次静态审阅未实际执行安装验证,且根据评分上限,由于没有CI/测试证据,故不能给出更高分数。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已使用 Telnyx 平台且需要在 IDE 内直接操作 Telnyx 资源的开发者
构建语音代理、短信自动化或电信相关 AI 应用的团队

不适合谁

不使用 Telnyx 服务、无 Telnyx API 密钥的用户
需要明确、逐一列出的工具清单才能评估集成风险的场景（源材料未提供具体工具名单）

所需权限

需要提供 Telnyx API 密钥（TELNYX_API_KEY），该密钥被标记为敏感信息
该密钥可授权对 Telnyx 账户执行操作（如短信发送、号码购买等电信资源管理），需妥善保管

风险与副作用

API 密钥一旦泄露，可能被用于在 Telnyx 账户上产生真实费用或滥用电信资源（如群发短信）
远程 MCP 服务器（api.telnyx.com）为托管服务，其可用性和行为变更依赖 Telnyx 官方维护，不受本地控制
源材料明确说明该仓库仍在积极开发中，接口和功能可能发生变化

安装接入

准备工作

运行环境：Node.js · 远程托管（无需本地环境）

TELNYX_API_KEY 必填密钥 Telnyx API key for authentication; get it from your Telnyx account dashboard.

方式一（本地 stdio 代理）：在支持 MCP 的客户端配置中添加命令 npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY，或设置环境变量 TELNYX_API_KEY 后运行该 npm 包；方式二（直接连接远程服务）：在客户端的 MCP 配置文件（如 Cursor 的 .cursor/mcp.json）中添加类型为 http 的服务器条目，指向 https://api.telnyx.com/v2/mcp。

.cursor/mcp.json

{
  "mcpServers": {
    "telnyx": {
      "command": "npx",
      "args": [
        "-y",
        "@telnyx/mcp",
        "--api-key=YOUR_TELNYX_API_KEY"
      ]
    }
  }
}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "telnyx": {
      "command": "npx",
      "args": [
        "-y",
        "@telnyx/mcp",
        "--api-key=YOUR_TELNYX_API_KEY"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add telnyx -- npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

Run `npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY` and connect from your client; the Telnyx tools (e.g. messaging/number management) should appear in the client's tool list.

常见排障

确认已正确设置 TELNYX_API_KEY 环境变量或在启动命令中传入 --api-key 参数
若使用 Cursor 的 http 连接方式，检查 .cursor/mcp.json 中的 url 字段是否为 https://api.telnyx.com/v2/mcp
确认 Node.js 环境可用以运行 npx 命令（本地 stdio 代理方式）
如遇账户权限或计费相关问题，检查 Telnyx 账户状态及 API 密钥权限范围

试试这样问

连接成功后，可以直接对 AI 助手这样说：

Search for available phone numbers in the US and buy one
Send an SMS to +15551234567 saying hello
Check my Telnyx account balance
Set up a new messaging profile for my number

使用场景

让编码助手直接调用 Telnyx 的短信、语音、号码等电信 API

在开发中管理 Telnyx 账户资源（如购买号码、配置消息资料）

为语音代理、IoT 或 WebRTC 项目提供 AI 驱动的电信工具接入

支持客户端

Cursor

Claude Code部分支持

Gemini CLI部分支持

依据项目文档列出，未经本站实测。

详细介绍

Telnyx MCP 是由 Telnyx 官方维护的 MCP 代理，将编码助手（如 Cursor、Claude Code、Gemini CLI）连接到 Telnyx 的远程 MCP 服务器（https://api.telnyx.com/v2/mcp），从而调用 Telnyx 的电信类 API 工具。该仓库同时提供 npm 包 @telnyx/mcp（通过 stdio 方式在本地运行并代理到远程服务），以及可直接以 HTTP 方式连接的远程托管 MCP 端点。仓库来源材料未列出具体工具名称或数量，只说明其用于'AI 驱动的电信工具'，覆盖短信、语音、号码管理、AI 助手、WebRTC 等 Telnyx 产品线。使用时需要提供 TELNYX_API_KEY 进行身份验证。