Groq MCP 语音助手

基于语音的模板，用于构建连接到远程模型上下文协议（MCP）服务器的AI助手，利用Groq的超快速推理能力

实时演示

查看实时应用

概述

此应用程序展示了使用Groq API进行闪电般快速推理，并结合模型上下文协议（MCP）服务器扩展功能的语音控制AI交互。作为一个完整的端到端模板，您可以分叉、定制并部署到Cloudflare Workers。

关键特性：

• 以语音为中心的界面：实时语音转文字和文字转语音，由浏览器API提供支持
• MCP集成：连接到远程模型上下文协议服务器，以扩展AI功能
• 超快速推理：借助Groq优化的推理基础设施实现亚秒级响应时间
• 现代用户界面：使用Svelte 5和Tailwind CSS构建的美观且响应式的界面
• 边缘部署：在全球范围内通过Cloudflare Workers进行低延迟部署
• 对话管理：通过可展开的UI面板跟踪对话历史和工具调用
• 实时状态更新：显示录音、处理和响应状态的实时更新

架构

技术栈：

• 前端：Svelte 5, Tailwind CSS, TypeScript
• 后端：Cloudflare Workers, Wrangler
• AI基础设施：Groq API用于推理
• 协议集成：模型上下文协议（MCP）用于服务器连接
• 音频处理：浏览器WebRTC API用于语音输入/输出

快速开始

预备条件

• 安装Node.js 18+
• Groq API密钥（在这里创建免费的GroqCloud账户并生成API密钥）
• 用于部署的Cloudflare账户

设置

1. 克隆仓库

   git clone https://github.com/build-with-groq/groq-mcp-voice-template
   cd groq-mcp-voice-template
   

2. 安装依赖项

   
   npm install
   

3. 配置环境变量 更新wrangler.jsonc中的API密钥：

   {
     "vars": {
       "GROQ_API_KEY": "your-groq-api-key-here",
       "APP_PASSWORD": "optional-app-password"
     }
   }
   

4. 启动开发服务器

   npm run dev:vite
   

5. 部署到Cloudflare Workers

   npm run deploy
   

使用方法

1. 当浏览器提示时授予麦克风权限
2. 点击麦克风按钮开始语音录制
3. 说出您的查询 - 接口会显示实时状态更新
4. 聆听AI回应 - 音频将自动播放
5. 在可展开的底部面板中查看对话历史和工具调用
6. 使用MCP服务器按钮配置MCP服务器以扩展功能

自定义

此模板旨在作为您语音AI应用程序的基础。自定义的关键领域包括：

• 模型选择：在语音代理组件中更新Groq模型配置
• UI/样式：在src/shared/components/中自定义主题和组件
• MCP服务器：通过内置管理器配置并连接到您自己的MCP服务器
• 语音设置：修改语音识别和合成设置
• 对话流程：扩展对话管理和历史记录功能

MCP集成

模板内置了对模型上下文协议服务器的支持：

• 服务器管理UI：通过网页界面配置MCP服务器连接
• 工具调用可视化：查看实时工具执行和响应
• 可扩展架构：轻松与自定义MCP服务器集成

下一步

对于开发者

• 创建您的免费GroqCloud账户：访问官方API文档、实验平台和其他资源，通过Groq控制台
• 构建和自定义：分叉此仓库并开始自定义，以构建您自己的语音AI应用程序
• 获取支持：与其他在Groq上构建的开发者交流，与我们的团队聊天，并在我们的Groq开发者论坛提交功能请求

对于创始人和企业领导者

• 查看企业功能：此模板展示了生产就绪的AI，能够处理具有语音接口的实时业务负载
• 讨论您的需求：联系我们探讨如何加速您的AI计划

许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详情。

致谢

由Julian Francisco创建。