groq-compound-mcp-server

groq-compound-mcp-server

compound/meta モデルを含む Groq モデルとやり取りするための Model Context Protocol（MCP）サーバーを提供します。

このサーバーは、次のツールを公開します。

• ask_with_realtime_information
• ask_with_code_execution

前提条件

• Node.js >= 18.0.0
• 環境変数 GROQ_API_KEY に設定された Groq API キー。

インストール

npm install groq-compound-mcp-server

使用方法

このサーバーは、トランスポートに stdio を使用する標準的な MCP サーバーパターンに従っています。MCP クライアント（Claude Desktop やカスタムクライアントなど）から実行するように設計されています。

MCP サーバーの設定と接続方法については、公式の MCP Quickstart for Server Developers を参照してください。

クライアントの設定時には、コマンド npx groq-compound-mcp-server または groq-compound-mcp-server（グローバルにインストールされている場合）を使用して、このサーバーを実行してください。

MCP クライアント（たとえば、settings.json ファイル内）でこのサーバーを起動する設定例を示します。

{
  "mcpServers": {
    "groq-compound": {
      "command": "npx",
      "args": [
        "-y",
        "groq-compound-mcp-server"
      ],
      "env": {
        "GROQ_API_KEY": "YOUR_GROQ_API_KEY_HERE"
      }
    }
  }
}

Vercel でのホスティング

このサーバーは Vercel にもデプロイできます。

1. 前提条件：

   • Vercel アカウントを用意してください。
   • Git リポジトリを Vercel に接続してください。

2. 環境変数： Vercel プロジェクトの設定で、次の環境変数を設定してください。

   • GROQ_API_KEY：Groq API キー。
   • REDIS_URL：（SSE トランスポートでの使用を推奨）Redis インスタンス（Vercel KV や Upstash など）の接続 URL。

3. ビルド設定： Vercel は Next.js アプリケーションとして自動的に検出するはずです。ビルドコマンド npm run build:vercel（または yarn build:vercel／pnpm build:vercel）と出力ディレクトリ（.next）が使用されます。

4. MCP サーバーへのアクセス： デプロイ後、MCP サーバーのエンドポイントは https://your-deployment-url.vercel.app/api/mcp で利用できます。 たとえば、SSE エンドポイントは https://your-deployment-url.vercel.app/api/mcp/sse です。

Vercel CLI を使った開発

Vercel のデプロイをローカルで実行するには、次の手順に従ってください。

1. Vercel CLI をインストールします：npm install -g vercel
2. 環境変数をローカルで設定します（たとえば、プロジェクトのルートにある .env.local ファイルに設定します）。

   GROQ_API_KEY=your_groq_api_key
   REDIS_URL=your_redis_url
   

3. 開発サーバーを実行します：vercel dev または npm run dev:vercel

ライセンス

MIT