Google Adk Elevenlabs MCP

🚀 Google ADKとElevenLabsに基づく音声ブロードキャストエージェント

このプロジェクトは、GoogleのAgent Development Kit (ADK) とElevenLabsのMCPサーバーを使用して構築されたテキスト読み上げ（TTS）音声ブロードキャストエージェントを展示しています。

🚀 クイックスタート

この音声ブロードキャストエージェントは、uvx を通じてElevenLabsのMCPサーバーに接続し、テキスト読み上げ機能を提供します。以下の技術を使用しています。

• Google ADK (Agent Development Kit)
• ElevenLabs MCPサーバー
• Python 3.11+

✨ 主な機能

• テキスト読み上げ機能を提供します。
• Google ADKとElevenLabsのMCPサーバーを利用して、安定した音声出力を実現します。

📦 インストール

前提条件

• Python 3.11以上
• ElevenLabs APIキー
• Google Gemini APIキー
• インストール済みのGoogle ADK

セットアップ手順

1. リポジトリをクローンします。

git clone <repo-url>

2. 仮想環境を作成し、アクティブ化します。

python3.11 -m venv venv
source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. ルートディレクトリに .env ファイルを作成し、ElevenLabsとGeminiのAPIキーを追加します。

ELEVENLABS_API_KEY=your_api_key_here
GOOGLE_API_KEY = your_api_key_here

💻 使用例

基本的な使用法

エージェントの起動

1. 仮想環境がアクティブ化されていることを確認します。

source venv/bin/activate

2. agents ディレクトリに移動します。

cd agents

3. ADKを使用してエージェントを起動します。非同期エージェントはウェブクライアントを通じてのみ起動できます。

adk web

エージェントはElevenLabsのMCPサーバーに接続し、テキスト読み上げリクエスト（およびMCPサーバーが提供するその他のサービスツール）を処理できる状態になります。

📚 ドキュメント

プロジェクト構造

google-adk-sample/
├── agents/
│   └── speaker/
│       ├── agent.py        # メインエージェントの実装
│       └── __init__.py
├── .env                    # 環境変数
└── requirements.txt        # プロジェクトの依存関係

トラブルシューティング

何か問題が発生した場合：

1. 仮想環境がアクティブ化されていることを確認します。
2. .env ファイル内のAPIキーが正しく設定されていることを検証します。
3. すべての依存関係が正しくインストールされていることを確認します。
4. コマンドが正しいディレクトリから実行されていることを確認します。

その他のリソース

• Google ADKドキュメント
• ElevenLabsドキュメント
• uvxドキュメント