Google Adk Elevenlabs MCP

🚀 基於 Google ADK 和 ElevenLabs 的語音播報智能體

本項目藉助 Google 的 Agent Development Kit (ADK) 與 ElevenLabs 的 MCP 服務器，構建了一個文本轉語音（TTS）的語音播報智能體，為文本語音轉換提供了高效的解決方案。

🚀 快速開始

先決條件

• Python 3.11 或更高版本
• ElevenLabs API Key
• Google Gemini API Key
• 已安裝的 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. 配置 API 密鑰：在根目錄下創建一個 .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 服務器提供的其他服務工具）

✨ 主要特性

該語音播報智能體通過 uvx 連接到 ElevenLabs 的 MCP 服務器，提供文本轉語音功能。它使用了以下技術：

• Google ADK (Agent Development Kit)
• ElevenLabs MCP 服務器
• Python 3.11+

📦 安裝指南

詳細的安裝步驟已在“快速開始”部分的“設置步驟”中說明，這裡不再贅述。

📚 詳細文檔

項目結構

google-adk-sample/
├── agents/
│   └── speaker/
│       ├── agent.py        # 主智能體實現
│       └── __init__.py
├── .env                    # 環境變量
└── requirements.txt        # 項目依賴項

故障排除

如果遇到任何問題，可以按照以下步驟排查：

1. 確保激活了虛擬環境
2. 驗證 .env 文件中的 API 密鑰是否正確設置
3. 檢查所有依賴項是否正確安裝
4. 確保從正確的目錄運行命令

更多資源

• Google ADK 文檔
• ElevenLabs 文檔
• uvx 文檔