🤖 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

---