Google ADK Speaker Agent with ElevenLabs

Name: Google ADK Speaker Agent with ElevenLabs
Author: reymerekar7

本地服务

github.com/reymerekar7AI 与智能体177 周前更新

代码仓库

关于 Google ADK Speaker Agent with ElevenLabs

这是一个使用 Google ADK 和 ElevenLabs MCP 服务构建文本转语音 Speaker Agent 的示例项目，面向希望了解该组合的开发者。项目通过 uvx 连接 ElevenLabs，并使用 ADK Web 客户端运行异步 Agent。

主要功能

01基于 Google ADK 构建 Speaker Agent
02通过 ElevenLabs MCP 服务提供文本转语音
03使用 uvx 连接 MCP 服务
04通过 ADK Web 运行异步 Agent

适用场景

01学习 Google ADK 与 ElevenLabs MCP 服务的连接方式
02搭建处理文本转语音请求的异步 Agent

MCP 相关

该项目中的 Agent 通过 uvx 连接 ElevenLabs MCP 服务，以使用其文本转语音能力及服务提供的其他工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "google-adk-elevenlabs": {
      "command": "uvx",
      "args": [
        "elevenlabs-mcp"
      ],
      "env": {
        "ELEVENLABS_API_KEY": "<ELEVENLABS_API_KEY>"
      }
    }
  }
}

启动命令uvx elevenlabs-mcp

需要配置的环境变量

ELEVENLABS_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypielevenlabs-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

使用 ElevenLabs 的 Google ADK 语音 Agent

本项目演示了一个使用 Google Agent Development Kit (ADK) 和 ElevenLabs MCP 服务构建的文本转语音（TTS）语音 Agent。

概览

语音 Agent 通过 uvx 连接到 ElevenLabs MCP 服务，以提供文本转语音功能。它使用以下组件构建：

前提条件

Python 3.11 或更高版本
ElevenLabs API 密钥
Google Gemini API 密钥
已安装 Google ADK

设置

克隆仓库：

git clone <repo-url>

创建并激活虚拟环境：

python3.11 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

安装依赖：

pip install -r requirements.txt

在根目录中创建 .env 文件，并填入 ElevenLabs 和 Gemini API 密钥：

ELEVENLABS_API_KEY=your_api_key_here
GOOGLE_API_KEY = your_api_key_here

运行 Agent

确保已激活虚拟环境：

source venv/bin/activate

cd agents

使用 ADK 运行 Agent。异步 Agent 只能通过 Web 客户端运行：

adk web

Agent 将连接到 ElevenLabs MCP 服务，并准备好处理文本转语音请求（以及 MCP 服务中其他可用工具的请求）。

项目结构

google-adk-sample/
├── agents/
│   └── speaker/
│       ├── agent.py        # Main agent implementation
│       └── __init__.py
├── .env                    # Environment variables
└── requirements.txt        # Project dependencies