Groq MCP Server

🚀 このプロジェクトについて

このプロジェクトは、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のサービス利用規約に従ってください。支援が必要な場合は、公式ドキュメントを参照するか、サポートチームに連絡してください。