Groq MCP 服务器

查询托管在 Groq 上的模型，通过 模型上下文协议 (MCP)，直接从 Claude 和其他 MCP 客户端进行闪电般的快速推理。

使用 MCP 访问视觉模型以解释图像中的视觉数据，从文本即时生成语音，通过 Groq 的 批量处理 处理数千个请求，甚至可以使用 Groq 的完整文档构建应用程序。

使用 Groq MCP 服务器，您可以尝试以下任务：

Agentic 任务、代码生成和网络搜索

• Groq 的 Compound Beta 是什么？使用 compound 工具。用一行总结，然后转换成语音
• 请从 CoinGecko API 获取当前的比特币价格，并计算 0.38474 个比特币的价值？
• 旧金山现在的天气怎么样？
• 生成并运行代码，这意味着您可以进行 API 调用、从网页获取数据等等
• 此功能使用新的 compound-beta agentic 工具系统

视觉与理解

• “描述这张图片 [图片 URL]”
• “分析这张图片并提取关键信息为 JSON [图片 URL]”

语音与音频

• “使用 Arista-PlayAI 语音将此文本转换为语音：[文本]”
• “用阿拉伯语大声朗读这段文字：[文本]”
• “使用 whisper-large-v3 转录此音频文件：[mp3 的 URL]”
• “将此外语音频翻译成英语 [mp3 的 URL]”

批量处理

• “处理以下提示批次：[jsonlines 文件的位置]”（阅读更多 此处）

Claude Desktop 快速入门

• 在 console.groq.com 免费获取 Groq API 密钥

2. 安装 uv (Python 包管理器)，使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装，或查看 uv repo 获取其他安装方法。
3. 转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，包含以下内容：

{
  "mcpServers": {
    "groq": {
      "command": "uvx",
      "args": ["groq-mcp"],
      "env": {
        "GROQ_API_KEY": "your_groq_api_key",
        "BASE_OUTPUT_PATH": "/path/to/output/directory"  # 可选：保存生成文件的位置（默认：~/Desktop）
      }
    }
  }
}

如果您使用的是 Windows，则必须在 Claude Desktop 中启用“开发者模式”才能使用 MCP 服务器。单击左上角汉堡菜单中的“帮助”，然后选择“启用开发者模式”。

如果您想从代码安装 MCP，请向下滚动到“贡献”。

其他 MCP 客户端

对于其他客户端，如 Cursor 和 Windsurf：

1. 安装软件包：

   # 使用 UV (推荐)
   uvx install groq-mcp
   
   # 或者使用 pip
   pip install groq-mcp
   

2. 生成配置：

   # 将配置打印到屏幕
   groq-mcp-config --api-key=your_groq_api_key --print
   
   # 或者直接保存到配置文件（自动检测位置）
   groq-mcp-config --api-key=your_groq_api_key
   
   # 可选：指定自定义输出路径
   groq-mcp-config --api-key=your_groq_api_key --output-path=/path/to/outputs
   

就是这样！您的 MCP 客户端现在可以使用这些 Groq 功能：

• 🗣️ 文本转语音 (TTS)：快速、自然的语音合成
• 👂 语音转文本 (STT)：准确的转录和翻译
• 🖼️ 视觉：高级图像分析和理解
• 💬 聊天：使用 Llama 4 等的超快速 LLM 推理
• 📦 批量：高效处理大型工作负载

贡献

如果您想贡献或从源代码运行：

安装选项

选项 1：快速设置（推荐）

1. 克隆存储库：

   git clone https://github.com/groq/groq-mcp-server
   cd groq-mcp
   

2. 运行设置脚本：

   ./scripts/setup.sh
   

   这将：

   • 使用 uv 创建 Python 虚拟环境
   • 安装所有依赖项
   • 设置 pre-commit 钩子
   • 激活虚拟环境

3. 运行 Claude 安装脚本：

   ./scripts/install.sh
   

   在 Mac 上，这会将 Groq MCP 服务器安装在 Claude Desktop 中，位于 ~/Library/Application Support/Claude/claude_desktop_config.json。请确保刷新或重启 Claude Desktop。

4. 将 .env.example 复制到 .env 并添加您的 Groq API 密钥：

   cp .env.example .env
   # 编辑 .env 并添加您的 API 密钥
   

选项 2：手动设置

1. 克隆存储库：

   git clone https://github.com/groq/groq-mcp-server
   cd groq-mcp
   

2. 创建虚拟环境并安装依赖项 使用 uv：

   uv venv
   source .venv/bin/activate
   uv pip install -e ".[dev]"
   

3. 将 .env.example 复制到 .env 并添加您的 Groq API 密钥：

   cp .env.example .env
   # 编辑 .env 并添加您的 API 密钥
   

可用脚本

scripts 目录包含用于不同 Groq API 功能的几个实用程序脚本：

视觉与图像分析

./scripts/groq_vision.sh <image_file> [prompt] [temperature] [max_tokens] [output_directory]
# 示例：
./scripts/groq_vision.sh "./input/image.jpg" "这张图片里有什么？"

文本转语音 (TTS)

./scripts/groq_tts.sh "您的文本" [voice_name] [model] [output_directory]
# 示例：
./scripts/groq_tts.sh "你好，世界！" "Arista-PlayAI"

语音转文本 (STT)

./scripts/groq_stt.sh <audio_file> [model] [output_directory]

实用程序脚本

• list_groq_voices.sh: 显示可用的 TTS 语音
• list_groq_stt_models.sh: 显示可用的 STT 模型
• groq_batch.sh: 处理批量操作
• groq_translate.sh: 翻译文本或音频

开发脚本

# 运行测试
./scripts/test.sh
# 运行带选项的测试
./scripts/test.sh --verbose --fail-fast
# 运行集成测试
./scripts/test.sh --integration

# 在本地调试和测试
mcp install server.py
mcp dev server.py

故障排除

使用 Claude Desktop 运行时，日志可以在以下位置找到：

• Windows: %APPDATA%\Claude\logs\groq-mcp.log
• macOS: ~/Library/Logs/Claude/groq-mcp.log

致谢

本项目受到 ElevenLabs MCP Server 的启发。 谢谢！