What is Compound Mcp Server

The compound-mcp-server is a Model Context Protocol (MCP) server designed for interacting with Groq models, including compound and meta models.

Use cases

Use cases for the compound-mcp-server include developing applications that need real-time insights from Groq models, executing code dynamically based on model outputs, and integrating with custom MCP clients for enhanced functionalities.

How to use

To use the compound-mcp-server, install it via npm with ‘npm install groq-compound-mcp-server’. Run the server using ‘npx groq-compound-mcp-server’ or ‘groq-compound-mcp-server’ if installed globally. Ensure to set the ‘GROQ_API_KEY’ environment variable with your Groq API key.

Key features

Key features of the compound-mcp-server include tools for real-time information queries (‘ask_with_realtime_information’) and code execution (‘ask_with_code_execution’).

Where to use

The compound-mcp-server can be used in various fields that require interaction with machine learning models, such as data analysis, AI development, and software engineering.

groq-compound-mcp-server

Provides a Model Context Protocol (MCP) server for interacting with Groq models, including compound/meta models.

This server exposes the following tools:

• ask_with_realtime_information
• ask_with_code_execution

Prerequisites

• Node.js >= 18.0.0
• A Groq API key set in the GROQ_API_KEY environment variable.

Installation

npm install groq-compound-mcp-server

Usage

This server follows the standard MCP server pattern using stdio for transport. It’s designed to be run by an MCP client (like Claude Desktop or a custom client).

Refer to the official MCP Quickstart for Server Developers for instructions on setting up and connecting MCP servers.

When configuring your client, use the command npx groq-compound-mcp-server or groq-compound-mcp-server (if installed globally) to run this server.

Here’s an example of how you might configure an MCP client (e.g., in a settings.json file) to launch this server:

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

Hosting on Vercel

This server can also be deployed to Vercel.

1. Prerequisites:

   • Ensure you have a Vercel account.
   • Connect your Git repository to Vercel.

2. Environment Variables:
   Set the following environment variables in your Vercel project settings:

   • GROQ_API_KEY: Your Groq API key.
   • REDIS_URL: (Recommended for SSE transport) The connection URL for a Redis instance (e.g., from Vercel KV or Upstash).

3. Build Configuration:
   Vercel should automatically detect it as a Next.js application. The build command npm run build:vercel (or yarn build:vercel/pnpm build:vercel) and the output directory (.next) will be used.

4. Accessing the MCP Server:
   Once deployed, your MCP server endpoints will be available at https://your-deployment-url.vercel.app/api/mcp.
   For example, the SSE endpoint would be https://your-deployment-url.vercel.app/api/mcp/sse.

Development with Vercel CLI

To run the Vercel deployment locally:

1. Install Vercel CLI: npm install -g vercel
2. Set up environment variables locally (e.g., in a .env.local file at the project root):

   GROQ_API_KEY=your_groq_api_key
   REDIS_URL=your_redis_url
   

3. Run the development server: vercel dev or npm run dev:vercel.

License

MIT