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的服務條款和條件。如需幫助，請參考官方文檔或聯繫支持團隊。