Eleven Labs MCP Integration

🚀 ElevenLabs MCP統合 - テックニュース更新エージェント

FastAPIバックエンドを使用して、ElevenLabsエージェントを作成します。このエージェントは、友好的で専門用語を使わないテックニュースの更新を外部に通話で配信します。このプロジェクトは、音声機能を備えた会話型AIエージェントを作成するためのElevenLabs MCP（Model Context Protocol）の統合を実証しています。

✨ 主な機能

• 会話型AIエージェント：自信があり、友好的でテクノロジーに精通した同僚のようなエージェントを作成します。
• 音声統合：ElevenLabsのAlice音声を使用して、自然な通話を実現します。
• テックニュース配信：AI、プログラミング、サイバーセキュリティに関する最新情報を提供します。
• シンプルなAPI：エージェントの作成と通話管理を簡単に行うことができるエンドポイントを備えています。
• MCP統合：ElevenLabs MCPを活用して、エージェントの管理をシームレスに行います。

📦 インストール

プロジェクト構造

ElevenLabs/
├── app/
│   ├── main.py              # エンドポイントを持つFastAPIアプリケーション
│   ├── elevenlabs_client.py # ElevenLabs APIクライアント関数
│   └── config.py            # 設定と環境変数
├── requirements.txt         # Python依存関係
├── .env.example            # 環境変数テンプレート
├── .gitignore              # Gitの無視ルール
└── README.md               # プロジェクトドキュメント

前提条件

• Python 3.8以上
• ElevenLabs APIキー
• ElevenLabsの電話番号（外部通話用）
• Git

インストール手順

1. リポジトリをクローンする

   git clone https://github.com/LEKKALAGANESH/Eleven-Labs-MCP-Integration.git
   cd Eleven-Labs-MCP-Integration
   

2. 依存関係をインストールする

   pip install -r requirements.txt
   

3. 環境変数を設定する

   cp .env.example .env
   # .envを実際の値で編集する
   

4. サーバーを起動する

   uvicorn app.main:app --reload
   

🔧 設定

以下の変数を持つ.envファイルを作成します。

ELEVENLABS_API_KEY=your_elevenlabs_api_key
ELEVENLABS_BASE_URL=https://api.elevenlabs.io/v1
AGENT_VOICE_ID=Xb7hH8MSUJpSbSDYk0k2
AGENT_PHONE_NUMBER_ID=your_phone_number_id

📚 詳細ドキュメント

APIエンドポイント

1. エージェントを作成する

POST /create-agent

事前定義された性格と音声を持つ新しいテックニュース更新エージェントを作成します。

レスポンス:

{
  "agent": {
    "agent_id": "agent_5701k1capwtse9fske3xgefspyra",
    "name": "Tech News Update Agent",
    "voice_id": "Xb7hH8MSUJpSbSDYk0k2"
  }
}

2. 外部通話を行う

POST /call

指定された電話番号に外部通話を開始します。

リクエストボディ:

{
  "phone_number": "+1234567890"
}

レスポンス:

{
  "result": {
    "conversation_id": "conv_3401k1casackffe9emj08wgf9zsd",
    "call_sid": "CA12265951d92ca816f1f15693d7efd6a2",
    "status": "success"
  }
}

💻 使用例

curlを使用する

1. エージェントを作成する:

   curl -X POST "http://localhost:8000/create-agent"
   

2. 通話を行う:

   curl -X POST "http://localhost:8000/call" \
        -H "Content-Type: application/json" \
        -d '{"phone_number": "+1234567890"}'
   

Python requestsを使用する

import requests

# エージェントを作成する
response = requests.post("http://localhost:8000/create-agent")
agent_data = response.json()
agent_id = agent_data["agent"]["agent_id"]

# 通話を行う
call_data = {"phone_number": "+1234567890"}
response = requests.post("http://localhost:8000/call", json=call_data)
print(response.json())

🤖 エージェントの性格

テックニュース更新エージェントは以下のように設定されています。

• トーン：自信があり、友好的で会話的
• 音声：自然なコミュニケーションのためのAlice（女性の音声）
• 専門知識：AI、プログラミング、サイバーセキュリティの最新情報
• スタイル：専門用語を使わず、実用的な意味を持つ説明
• アプローチ：興味深いニュースを共有する知識豊富な同僚のようなスタイル

⚠️ 重要な注意事項

⚠️ 重要提示

• 未検証の番号に通話するには、検証済みまたは有料のElevenLabs/Twilioアカウントが必要です。
• エージェントを作成した後、main.pyのagent_idを返されたIDで更新してください。
• ElevenLabs APIのレート制限と使用クォータに注意してください。
• 実際のAPIキーをバージョン管理にコミットしないでください。

🔗 関連リンク

• ElevenLabs APIドキュメント
• FastAPIドキュメント
• MCP (Model Context Protocol)

📄 ライセンス

このプロジェクトはオープンソースで、MITライセンスの下で利用可能です。

🤝 コントリビューション

コントリビューションは歓迎されます！プルリクエストを送信してください。

📞 サポート

サポートが必要な場合は、GitHubリポジトリに問題を開くか、メンテナに連絡してください。

ElevenLabs MCP統合を使用して❤️ で作成されました