Groq MCP Server

Groq MCP サーバー

Groq でホストされているモデルに、Model Context Protocol（MCP） を通じて Claude やその他の MCP クライアントから直接クエリを送り、超高速の推論を利用できます。

MCP を使って、画像の視覚データを解釈するビジョンモデルにアクセスしたり、テキストからすぐに音声を生成したり、Groq の バッチ処理 で何千ものリクエストを処理したり、Groq のドキュメントにフルアクセスできるアプリを構築したりできます。

Groq MCP サーバーでは、次のようなタスクを試すことができます。

エージェント型タスク、コード生成、ウェブ検索

• Groq の Compound Beta とは何ですか？compound ツールを使ってください。1 行で要約してから、音声に変換してください
• CoinGecko API から現在のビットコイン価格を取得して、0.38474 ビットコインの価値を計算してください
• 現在の SF の天気はどうですか？
• コードを生成して実行できます。つまり、API 呼び出しやウェブページからのデータ取得など、さまざまなことができます
• この機能では、新しい compound-beta エージェント型ツールシステム を使用します

ビジョンと理解

• 「この画像を説明してください [画像の 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 のリポジトリをご覧ください。
3. Claude > Settings > Developer > Edit Config > 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"  # Optional: Where to save generated files (default: ~/Desktop)
      }
    }
  }
}

Windows を使用している場合、MCP サーバーを使うには Claude Desktop で「Developer Mode」を有効にする必要があります。左上のハンバーガーメニューから「Help」をクリックし、「Enable Developer Mode」を選択してください。

コードから MCP をインストールする場合は、「Contributing」までスクロールしてください。

その他の MCP クライアント

Cursor や Windsurf など、その他のクライアントの場合：

1. パッケージをインストールします：

   # Using UV (recommended)
   uvx install groq-mcp
   
   # Or using pip
   pip install groq-mcp
   

2. 設定を生成します：

   # Print config to screen
   groq-mcp-config --api-key=your_groq_api_key --print
   
   # Or save directly to config file (auto-detects location)
   groq-mcp-config --api-key=your_groq_api_key
   
   # Optional: Specify custom output path
   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
   # Edit .env and add your API key
   

方法 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
   # Edit .env and add your API key
   

利用可能なスクリプト

script ディレクトリには、Groq API のさまざまな機能に対応するユーティリティスクリプトが含まれています：

ビジョンと画像分析

./scripts/groq_vision.sh <image_file> [prompt] [temperature] [max_tokens] [output_directory]
# Example:
./scripts/groq_vision.sh "./input/image.jpg" "What is in this image?"

テキスト読み上げ（TTS）

./scripts/groq_tts.sh "Your text" [voice_name] [model] [output_directory]
# Example:
./scripts/groq_tts.sh "Hello, world!" "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：テキストまたは音声を翻訳します

開発用スクリプト

# Run tests
./scripts/test.sh
# Run with options
./scripts/test.sh --verbose --fail-fast
# Run integration tests
./scripts/test.sh --integration

# Debug and test locally
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に着想を得ています。ありがとうございます！