🚀 Telnyx本地模型上下文协议（MCP）服务器

Telnyx本地模型上下文协议（MCP）服务器是官方推出的一款强大工具，它支持与语音、消息和AI助手等强大的API进行交互。借助此服务器，像Claude Desktop、Cursor、Windsurf、OpenAI代理以及其他MCP客户端，能够轻松管理电话号码、发送消息、拨打电话，还能创建AI助手。

🚀 快速开始

使用Claude Desktop快速入门

1. 从Telnyx控制台获取您的API密钥。
2. 安装uvx（Python包管理器），您可以使用以下命令进行安装：
   • curl -LsSf https://astral.sh/uv/install.sh | sh
   • brew install uv
   • 也可参考uv仓库中的其他安装方法。
3. 打开Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：

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

⚠️ 重要提示： 如果您使用的是Windows系统，需要在Claude Desktop中启用“开发者模式”才能使用MCP服务器。具体操作是点击菜单栏中的汉堡图标 > 帮助 > 启用开发者模式。

下载后运行

1. 从Telnyx控制台获取您的API密钥。
2. 安装uvx（Python包管理器），安装命令如下：
   • curl -LsSf https://astral.sh/uv/install.sh | sh
   • brew install uv
   • 或参考uv仓库中的其他安装方法。
3. 在终端中运行以下命令以下载代码库：

git clone git+https://github.com/team-telnyx/telnyx-mcp-server.git
cd telnyx-mcp-server

4. 安装依赖项并运行服务器：

pip install -r requirements.txt
python src/telnyx_mcp_server/server.py

📦 安装指南

安装过程主要涉及获取API密钥和安装uvx（Python包管理器），具体步骤如下：

• 获取API密钥：从Telnyx控制台获取。
• 安装uvx：
  • curl -LsSf https://astral.sh/uv/install.sh | sh
  • brew install uv
  • 参考uv仓库中的其他安装方法。

💻 使用示例

基础用法

# 配置API密钥
import os
os.environ['TELNYX_API_KEY'] = 'your_api_key_here'

# 调用Telnyx API进行语音通话
from telnyx import TelnyxClient
client = TelnyxClient()
response = client.make_call(
    from_number='您的电话号码',
    to_number='目标电话号码',
    message='您好！这是测试消息。'
)
print(response.status_code)

✨ 主要特性

可用工具

• 配置API密钥：在.env文件中添加TELNYX_API_KEY=YOUR_API_KEY。
• 日志记录：默认情况下，日志保存在当前目录的logs/文件夹中。

即将推出的功能

• 支持更多API端点：未来版本将添加对更多Telnyx服务的支持。
• 批量操作：计划增加批量处理功能，提高效率。

🤝 贡献指南

1. 克隆仓库并安装依赖：

git clone https://github.com/team-telnyx/telnyx-mcp-server.git
cd telnyx-mcp-server
pip install -r requirements.txt

2. 创建功能分支并提交更改。
3. 提交拉取请求至主仓库。

🔧 故障排除

日志定位

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

错误信息：“MCP Telnyx: spawn uvx ENOENT”

运行以下命令确认uvx的绝对路径：

which uvx

将输出的路径（例如，/usr/local/bin/uvx）更新到配置中，确保正确引用可执行文件。

其他问题

如需进一步帮助，请参考官方文档或在社区论坛发帖求助。