Telnyx Local Model Context Protocol (MCP) Server

基本能力

产品定位

Telnyx MCP Server 是一个通信和AI助手集成平台，旨在通过MCP协议提供电话、消息和AI助手功能。

核心功能

1. AI助手工具：创建、列表、获取、更新、删除AI助手，以及获取助手配置。
2. 呼叫控制工具：拨打电话、挂断电话、转移呼叫、播放音频、停止播放、发送DTMF音、文本转语音。
3. 消息工具：发送SMS和MMS消息，获取消息详情。
4. 电话号码工具：列表、购买、更新电话号码配置，以及列出可用电话号码。
5. 连接工具：列表、获取、更新语音连接配置。

适用场景

1. 创建AI客服助手处理电子商务业务。
2. 发送预约确认短信。
3. 拨打电话并转接至支持团队。
4. 查找特定地区的电话号码。
5. 创建自动应答系统。

工具列表

1. Assistant Tools：管理AI助手及其配置。
2. Call Control Tools：控制电话呼叫的各个方面。
3. Messaging Tools：处理短信和彩信的发送与接收。
4. Phone Number Tools：管理电话号码的购买和配置。
5. Connection Tools：管理语音连接的配置。

常见问题解答

1. 日志位置：Windows在%APPDATA%\Claude\logs\mcp-server-telnyx.log，macOS在~/Library/Logs/Claude/mcp-server-telnyx.log。
2. uvx路径错误：使用which uvx获取绝对路径并更新配置。

使用教程

使用依赖

1. 从Telnyx Portal获取API密钥。
2. 安装uvx（Python包管理器）： bash curl -LsSf https://astral.sh/uv/install.sh | sh 或 bash brew install uv

安装教程

1. 克隆Git仓库： bash git clone https://github.com/team-telnyx/telnyx-mcp-server.git cd telnyx-mcp-server
2. 在Claude配置中引用本地文件夹： json { "mcpServers": { "Telnyx": { "command": "uvx", "args": ["--from", "/path/to/telnyx-mcp-server", "telnyx-mcp-server"], "env": { "TELNYX_API_KEY": "<insert-your-api-key-here>" } } } }

调试方式

1. 创建虚拟环境并安装依赖： bash uv venv source .venv/bin/activate uv pip install -e .
2. 创建.env文件并添加API密钥： bash echo "TELNYX_API_KEY=YOUR_API_KEY" > .env
3. 运行测试： bash pytest
4. 在Claude Desktop中安装服务器： bash mcp install src/telnyx_mcp_server/server.py
5. 使用MCP Inspector本地调试： bash mcp dev src/telnyx_mcp_server/server.py

许可证

该项目遵循 None 开源许可条款。