groq-mcp-server

🚀 项目介绍 - Groq MCP服务器

这个项目是专门为Groq开发的一个MCP（模型上下文协议）服务器，它支持通过命令行与Groq进行交互。借助该服务器，用户能够通过简单的命令调用Groq的AI功能，涵盖图像分析、文本转语音（TTS）、语音识别（STT）等多个方面。

🚀 快速开始

使用Claude Desktop快速入门

1. 获取Groq API密钥
   • 访问https://www.groq.com并注册一个开发者账户。
   • 在控制台中创建一个新的API密钥。
2. 安装uv工具
   • 打开终端，运行以下命令：

uv init

- 按照提示完成uv的初始化配置。

3. 安装Groq MCP服务器 - 运行以下命令安装服务器：

./scripts/install.sh

- 对于Mac用户，此命令会将Groq MCP服务器安装到Claude Desktop中的相关配置文件中（路径为：`~/Library/Application Support/Claude/claude_desktop_config.json`）。请确保重新启动或刷新Claude Desktop以应用更改。

4. 复制环境变量示例 - 复制.env.example文件：

cp .env.example .env

- 打开`.env`文件，添加您的Groq API密钥：

GROQ_API_KEY=your_api_key_here

其他MCP客户端的使用方法

使用uv工具安装和运行服务器

1. 创建虚拟环境并安装依赖
   • 运行以下命令创建并激活虚拟环境：

uv venv
source .venv/bin/activate

- 安装项目依赖：

uv pip install -e ".[dev]"

2. 使用脚本调用功能

图像分析

./scripts/groq_vision.sh <图片文件路径> [提示词] [温度值] [最大令牌数] [输出目录]
# 示例：
./scripts/groq_vision.sh "./输入/图片.jpg" "这张图片里有什么？"

文本转语音（TTS）

./scripts/groq_tts.sh "<您的文本>" [语音名称] [模型名称] [输出目录]
# 示例：
./scripts/groq_tts.sh "你好，世界！" "Arista-PlayAI"

语音识别（STT）

./scripts/groq_stt.sh <音频文件路径> [模型名称] [输出目录]

其他实用脚本

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

🔧 贡献指南

快速设置安装

1. 克隆仓库

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

2. 激活虚拟环境并安装依赖

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

3. 复制并配置环境变量

cp .env.example .env
# 编辑.env文件，添加您的API密钥：
GROQ_API_KEY=your_api_key_here

可用脚本

视觉与图像分析

./scripts/groq_vision.sh <图片文件> [提示] [温度值] [最大令牌数] [输出目录]
# 示例：
./scripts/groq_vision.sh "./输入/图片.jpg" "这张图片里有什么？"

文本转语音（TTS）

./scripts/groq_tts.sh "<文本>" [语音名称] [模型名称] [输出目录]
# 示例：
./scripts/groq_tts.sh "你好，世界！" "Arista-PlayAI"

语音识别（STT）

./scripts/groq_stt.sh <音频文件> [模型名称] [输出目录]

开发脚本

测试脚本

# 运行测试：
./scripts/test.sh

❗ 故障排除与支持

遇到问题时，请检查终端中的错误信息或查阅文档。您也可以通过以下方式寻求帮助：

• 访问https://support.groq.com提交工单。
• 加入Groq的开发者社区论坛，与其他开发者交流经验。

⚠️ 注意事项

请确保始终使用最新的API密钥，并遵守Groq的服务条款和条件。如需帮助，请参考官方文档或联系支持团队。