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で「開発者モード」を有効にする必要があります。メニューバーのハンバーガーアイコン > ヘルプ > 開発者モードを有効にします。

ダウンロード後の実行

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
   

📦 インストール

• uvxのインストール：
  • curl -LsSf https://astral.sh/uv/install.sh | sh
  • brew install uv
  • またはuvリポジトリの他のインストール方法を参照。
• コードリポジトリのダウンロード：

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

• 依存関係のインストール：

  pip install -r requirements.txt
  

💻 使用例

基本的な使用法

# 配置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）を設定に更新し、実行可能ファイルを正しく参照するようにします。

その他の問題

さらなるヘルプが必要な場合は、公式ドキュメントを参照するか、コミュニティフォーラムで質問してください。