Groq MCP语音助手
支持语音的模板,用于构建连接至远程模型上下文协议(MCP)服务器并具备Groq超快速推理能力的AI助手
现场演示
概述
本应用程序演示了使用Groq API进行语音控制的AI交互,该API可实现闪电般的推理速度,并结合模型上下文协议(MCP)服务器以扩展功能。它作为一个完整、端到端的模板构建而成,您可以对其进行分支、定制并部署到Cloudflare Workers上。
主要特点:
- 语音优先界面由浏览器API支持的实时语音转文字和文字转语音功能
- MCP集成连接到远程模型上下文协议服务器以扩展AI功能
- 超快速推理由Groq优化的推理基础设施支持,实现亚秒级响应时间
- 现代用户界面使用Svelte 5和Tailwind CSS构建的美观且响应式的界面
- 边缘部署在全球范围内通过Cloudflare Workers部署,实现最低延迟
- 对话管理通过可扩展的用户界面面板追踪对话历史和工具调用
- 实时状态实时状态更新,显示录制、处理和响应状态
建筑
技术栈:
- 前端: Svelte 5,Tailwind CSS,TypeScript
- 后端: Cloudflare Workers,Wrangler(注:Wrangler 是 Cloudflare 提供的一个命令行工具,用于部署和管理 Cloudflare Workers 服务)
- 人工智能基础设施: Groq推理用API
- 协议集成: 服务器连接的模型上下文协议(MCP)
- 音频处理: 浏览器WebRTC API用于语音输入/输出
快速入门
先决条件
- 已安装 Node.js 18 或更高版本
- 根据上面的信息,执行如下指令:你是个专业的翻译,负责把英语内容翻译成中文内容,请帮我翻译一下原文内容创建一个免费的GroqCloud账户并在此生成API密钥)
- 用于部署的Cloudflare账户
设置
- 克隆仓库
git clone https://github.com/build-with-groq/groq-mcp-voice-template
cd groq-mcp-voice-template- 安装依赖项
npm install- 配置环境变量
更新 wrangler.jsonc 使用您的API密钥:
{
"vars": {
"GROQ_API_KEY": "your-groq-api-key-here",
"APP_PASSWORD": "optional-app-password"
}
}- 启动开发服务器
npm run dev:vite- 部署到 Cloudflare Workers
npm run deploy用法
- 授予麦克风权限 当浏览器提示时
- 点击麦克风按钮 开始录音
- 说出你的问题 - 界面将显示实时状态更新
- 听人工智能的回复 - 音频将自动播放
- 查看聊天历史记录 以及可扩展底部面板中的工具调用
- 配置MCP服务器 使用“MCP服务器”按钮以获取扩展功能
定制化
此模板旨在作为您语音AI应用的基础。主要的自定义区域包括:
- 模型选择: 在语音代理组件中更新Groq模型配置
- 用户界面/样式设计: 自定义主题和组件
src/shared/components/ - MCP 服务器: 通过内置管理器配置并连接到您自己的MCP服务器
- 语音设置: 修改语音识别和合成设置
- 对话流程: 扩展对话管理和历史记录功能
MCP集成
该模板内置了对模型上下文协议服务器的支持:
- 服务器管理用户界面通过网页界面配置MCP服务器连接
- 工具调用可视化查看实时工具执行情况和响应
- 可扩展架构与自定义MCP服务器轻松集成
下一步行动
对于开发者
- 创建您的免费GroqCloud账户访问官方API文档、实验平台以及更多资源,请通过 Groq 控制台
- 构建并自定义克隆此仓库并开始自定义,以构建您自己的语音AI应用程序
- 获取支持与在Groq上开发的其他开发者建立联系,与我们的团队交流,并在我们的平台上提交功能需求 Groq开发者论坛
为创始人和商业领袖
- 查看企业能力此模板展示了可投入生产的AI,能够通过语音界面处理实时业务工作负载
- 讨论您的需求: 联系我们的团队 探索Groq如何加速您的AI项目
许可证
本项目采用MIT许可证授权,请参阅LICENSE文件了解详情。
功劳/学分
由……创建 朱利安·弗朗西斯科。
