MCP-GROQ-SERVER
Gilberto-Galan/MCP-GROQ-SERVER
Chat interativo com LLMs Groq via MCP e CLI Python
Ver no GitHubServidor MCP (Model Context Protocol) com interface CLI para conversar com LLMs via API Groq. Mantém histórico de conversação, suporta modelos Llama 3.3, Mixtral e Gemma2, e oferece ferramentas MCP para chat simples, chat com histórico e listagem de modelos.
Instalação
npx convez-ai Gilberto-Galan/MCP-GROQ-SERVER1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Prototipagem rápida de aplicações com LLM via terminal
- Integração de modelos Groq em fluxos MCP customizados
- Chat conversacional multi-turno com histórico persistente
Veredito

Implementação prática e bem documentada de servidor MCP para integração com API Groq. Ideal para desenvolvedores que querem explorar LLMs gratuitos em velocidade alta, com interface CLI funcional e estrutura extensível.
README
A tradução para o português deste README ainda está na fila.
🤖 MCP-GROQ-SERVER
Servidor MCP (Model Context Protocol) con interfaz de línea de comandos (CLI) para chatear con modelos LLM a través de la API de Groq. Mantiene historial de conversación y permite interacción multi-turno directamente desde la terminal.
✨ Características
- Chat conversacional con historial completo desde la terminal
- Tres tools MCP disponibles: chat simple, chat con historial y listado de modelos
- Integración con la API de Groq (gratuita y de alta velocidad)
- Modelo por defecto:
llama-3.3-70b-versatile - Configuración de API Key mediante variables de entorno
- Entorno virtual aislado con venv
🧠 Modelo de IA
| Modelo | Proveedor | Tokens de contexto | Velocidad |
|---|---|---|---|
llama-3.3-70b-versatile | Meta via Groq | 128,000 | ~900 tok/s |
llama-3.1-8b-instant | Meta via Groq | 128,000 | ~2,000 tok/s |
mixtral-8x7b-32768 | Mistral via Groq | 32,768 | ~700 tok/s |
gemma2-9b-it | Google via Groq | 8,192 | ~800 tok/s |
📦 Paquetes instalados
| Paquete | Versión | Descripción |
|---|---|---|
mcp | latest | SDK oficial de Model Context Protocol |
groq | latest | Cliente oficial de la API de Groq |
python-dotenv | latest | Carga variables de entorno desde .env |
📋 Requisitos
- Python 3.10 o superior
- Cuenta gratuita en Groq Console
- Git
🚀 Instalación
1. Clona el repositorio
git clone https://github.com/tu-usuario/MCP-GROQ-SERVER.git
cd MCP-GROQ-SERVER
2. Crea y activa el entorno virtual
# Crear el venv
python -m venv venv
# Activar en Mac / Linux
source venv/bin/activate
# Activar en Windows
venv\Scripts\activate
3. Instala las dependencias
pip install mcp groq python-dotenv
4. Configura tu API Key
Crea un archivo .env en la raíz del proyecto:
GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxxxxxx
Obtén tu API Key gratis en console.groq.com → API Keys.
▶️ Uso
Con el venv activado, ejecuta:
python cli.py
El cliente levanta el servidor MCP automáticamente en segundo plano y abre la interfaz de chat:
=== Cliente MCP ===
Escribe 'salir' para terminar.
Tú: ¿Qué es Docker?
Asistente: Docker es una plataforma de contenedores que permite...
Tú: ¿Y cómo se diferencia de una máquina virtual?
Asistente: A diferencia de una VM, Docker no virtualiza el hardware...
Tú: salir
Escribe salir para cerrar el chat. El servidor se cierra automáticamente.
🗂️ Estructura del proyecto
MCP-GROQ-SERVER/
├── server.py # Servidor MCP con las tools de Groq
├── cli.py # Cliente CLI interactivo
├── .env # API Key (no se sube a git)
├── .gitignore
└── README.md
🛠️ Tools MCP disponibles
| Tool | Descripción |
|---|---|
chat | Chat simple con un prompt |
chat_with_history | Chat multi-turno con historial completo |
list_models | Lista los modelos disponibles |