Telnyx MCP Server

🚀 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）更新到配置中，確保正確引用可執行文件。

其他問題

如需進一步幫助，請參考官方文檔或在社區論壇發帖求助。