groq-compound-mcp-server
About
It is a Model Context Protocol (MCP) server that provides tools for interacting with Groq models, including compound/meta models. It is designed for developers integrating Groq AI capabilities into MCP-compatible clients.
Details
- Author
- groq
- GitHub stars
- 53
- Downloads
- 344
- Categories
- Other
Jump to
- Provides tools ask_with_realtime_information and ask_with_code_execution.
- Uses stdio transport for standard MCP integration.
- Supports deployment on Vercel for remote access.
- Optional SSE transport via Redis for Vercel deployments.
- Requires only Node.js ≥ 18.0.0 and a Groq API key.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
groq-compound-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package via npm install groq-compound-mcp-server, set the GROQ_API_KEY environment variable, and configure an MCP client (e.g., Claude Desktop) to launch the server using npx groq-compound-mcp-server. Alternatively, deploy on Vercel with optional Redis for SSE support.
ask_with_realtime_information
Ask a question requiring real-time information (e.g., news, current events) using a Groq model.
ask_with_code_execution
Ask questions that benefit from Python REPL interaction (e.g., for intermediate calculations or code execution).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"groq-compound-mcp-server": {
"groq-compound": {
"command": "npx",
"args": [
"-y",
"groq-compound-mcp-server"
],
"env": {
"GROQ_API_KEY": ""
}
}
}
}
}McpServers
{
"groq-compound": {
"command": "npx",
"args": [
"-y",
"groq-compound-mcp-server"
],
"env": {
"GROQ_API_KEY": ""
}
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
