groq-compound-mcp-server

Name: groq-compound-mcp-server
Author: groq

本地服务

github.com/groqAI 与智能体5610 周前更新

代码仓库

关于 groq-compound-mcp-server

groq-compound-mcp-server 是一个 MCP 服务，用于调用 Groq 的 compound 及 meta 模型。它面向需要在 MCP 客户端中使用实时信息检索或代码执行能力的开发者。

主要功能

01提供实时信息查询工具 ask_with_realtime_information
02提供代码执行工具 ask_with_code_execution
03通过 stdio 传输运行
04需要设置 GROQ_API_KEY 环境变量
05支持部署到 Vercel 并使用 SSE 传输

适用场景

01在 Claude Desktop 等客户端中让模型查询最新信息
02让模型运行代码并返回结果
03将 Groq 模型以 MCP 服务的形式部署到 Vercel

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 ask_with_realtime_information 和 ask_with_code_execution 两个工具。

#managed-by-terraform

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y groq-compound-mcp-server

需要配置的环境变量

GROQ_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgroq-compound-mcp-serverstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
question	string	是	要向模型提出的问题，尤其是需要实时信息的问题（例如最新新闻、近期事件）。
model	enum	否	要使用的模型（compound-beta 或 compound-beta-mini）。默认为 compound-beta。快速回答请使用 compound-beta-mini。compound-beta \| compound-beta-mini
mode	enum	否	响应模式（'minimal' 或 'verbose'）。默认为 'minimal'。'verbose' 会在响应中包含已执行的工具。该模式会产生非常详细的响应，仅应在用户提出要求或没有它就无法回答用户问题时使用（始终先尝试不使用它）。minimal \| verbose
include_domains	array	否	要在搜索中明确包含的域名列表。
exclude_domains	array	否	要从搜索中排除的域名列表。

详细介绍

groq-compound-mcp-server

提供一个用于与 Groq 模型（包括 compound/meta 模型）交互的模型上下文协议（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

用法

此服务遵循标准的 MCP 服务模式，使用 stdio 进行传输。它专为由 MCP 客户端（如 Claude Desktop 或自定义客户端）运行而设计。

有关设置和连接 MCP 服务的说明，请参阅官方的 MCP 服务开发者快速入门。

配置客户端时，请使用命令 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。

先决条件：
- 确保你拥有 Vercel 账户。
- 将 Git 仓库连接到 Vercel。
环境变量：在 Vercel 项目设置中设置以下环境变量：
- GROQ_API_KEY：你的 Groq API 密钥。
- REDIS_URL：（建议用于 SSE 传输）Redis 实例的连接 URL（例如来自 Vercel KV 或 Upstash）。
构建配置： Vercel 应会自动将其识别为 Next.js 应用。将使用构建命令 npm run build:vercel（或 yarn build:vercel/pnpm build:vercel）和输出目录（.next）。
访问 MCP 服务：部署完成后，可通过 https://your-deployment-url.vercel.app/api/mcp 访问 MCP 服务端点。例如，SSE 端点为 https://your-deployment-url.vercel.app/api/mcp/sse。

使用 Vercel CLI 进行开发

如需在本地运行 Vercel 部署：

安装 Vercel CLI：npm install -g vercel
在本地设置环境变量（例如，在项目根目录的 .env.local 文件中）：
```
GROQ_API_KEY=your_groq_api_key
REDIS_URL=your_redis_url
```
运行开发服务器：vercel dev 或 npm run dev:vercel。