convez.ai
MCP ServerIntegração & APIsIntermediário
Gilberto-Galan

MCP-GROQ-SERVER

Gilberto-Galan/MCP-GROQ-SERVER

Chat interativo com LLMs Groq via MCP e CLI Python

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-SERVER

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

Python MCP Groq Model License

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

ModeloProveedorTokens de contextoVelocidad
llama-3.3-70b-versatileMeta via Groq128,000~900 tok/s
llama-3.1-8b-instantMeta via Groq128,000~2,000 tok/s
mixtral-8x7b-32768Mistral via Groq32,768~700 tok/s
gemma2-9b-itGoogle via Groq8,192~800 tok/s

📦 Paquetes instalados

PaqueteVersiónDescripción
mcplatestSDK oficial de Model Context Protocol
groqlatestCliente oficial de la API de Groq
python-dotenvlatestCarga 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

ToolDescripción
chatChat simple con un prompt
chat_with_historyChat multi-turno con historial completo
list_modelsLista los modelos disponibles

Ver o original no GitHub

Bom para

Relacionados