convez.ai
MCP ServerDesenvolvimento WebIntermediário
Gilberto-Galan

Mentat — Assistente de Código MCP com Groq

Gilberto-Galan/mentat-asistente

Assistente MCP para Copilot que revisa código, gera testes e docs automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra-se nativamente ao GitHub Copilot no VS Code, funcionando como assistente inteligente para revisão de código, geração de testes, documentação e execução de comandos. Utiliza o modelo Llama 3.3 70B via API gratuita do Groq com suporte a múltiplas linguagens de programação.

Instalação

$npx convez-ai Gilberto-Galan/mentat-asistente

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

  • Revisar código com sugestões automáticas de melhorias
  • Gerar unit tests em pytest, Jest, JUnit e outros frameworks
  • Criar docstrings e documentação nativa para múltiplas linguagens
  • Executar comandos e explorar estrutura do projeto via chat
  • Sugerir commits semânticos com Conventional Commits

Veredito

MCP bem estruturado com integração direta ao Copilot e suporte multi-linguagem sólido. Groq oferece inferência rápida gratuita. Recomendado para times que já usam VS Code e buscam ampliar capacidades nativas do Copilot com automação de qualidade de código.

README

A tradução para o português deste README ainda está na fila.

🧠 Mentat — MCP Code Assistant

Python MCP Groq Model VS Code License

Servidor MCP (Model Context Protocol) integrado con GitHub Copilot en VS Code. Actúa como asistente de desarrollo inteligente que amplía las capacidades nativas de Copilot usando la API de Groq con el modelo Llama 3.3 70B.

Permite revisar código, generar tests, documentar, ejecutar comandos y más en múltiples lenguajes de programación, directamente desde el chat de Copilot en VS Code.


✨ Características

  • ✅ Integración nativa con GitHub Copilot Chat en VS Code
  • ✅ Soporte multi-lenguaje (Python, JavaScript, TypeScript, Java, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, C++, C y más)
  • ✅ Revisión automática de código con sugerencias de mejora
  • ✅ Generación de unit tests (pytest, Jest, JUnit, xUnit, RSpec, PHPUnit, etc.)
  • ✅ Generación de documentación con estilos nativos (Google Docstrings, JSDoc, TSDoc, Javadoc, etc.)
  • ✅ Lectura y exploración de archivos del proyecto
  • ✅ Ejecución de comandos desde el chat
  • ✅ Sugerencias inteligentes de commits con Conventional Commits
  • ✅ Chat conversacional con historial completo
  • ✅ Motor: Llama 3.3 70B via Groq (gratuito)

🛠️ Tools disponibles

ToolDescripción
chatChat simple con un prompt
chat_with_historyChat multi-turno con historial
list_modelsLista los modelos disponibles
leer_archivoLee el contenido de un archivo
listar_archivosMuestra la estructura del proyecto
revisar_codigoRevisa un archivo y sugiere mejoras
generar_testsGenera unit tests con pytest
generar_docsGenera docstrings y documentación
ejecutar_comandoEjecuta comandos en la terminal
sugerir_commitSugiere mensajes de commit

📦 Dependencias principales

PaqueteDescripción
mcpSDK oficial de Model Context Protocol
groqCliente oficial de la API de Groq
python-dotenvCarga variables de entorno desde .env
richRenderizado de terminal con estilos avanzados

📋 Requisitos

  • Python 3.10 o superior
  • VS Code 1.99 o superior
  • Extensión GitHub Copilot instalada en VS Code
  • Cuenta gratuita en Groq Console
  • Git

🚀 Instalación

1 — Clona el repositorio

git clone https://github.com/tu-usuario/mentat.git
cd mentat

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 rich

4 — Configura tu API Key

Crea un archivo .env en la raíz del proyecto:

GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxx

Obtén tu API Key gratis en console.groq.com → API Keys.


⚙️ Configuración en VS Code

1 — Verifica tu versión de VS Code

Help → About → debe ser 1.99 o superior

Si necesitas actualizar: code.visualstudio.com

2 — Obtén la ruta del Python de tu venv

Con el venv activado en la terminal:

# Windows
where python

# Mac / Linux
which python

Copia esa ruta, la necesitarás en el siguiente paso.

3 — Abre la configuración MCP de VS Code

Ctrl + Shift + P → "MCP: Open User Configuration" → Enter

4 — Agrega la configuración del servidor

{
    "servers": {
        "mentat": {
            "type": "stdio",
            "command": "C:\\TuUsuario\\TuUsuario\\ruta\\mentat\\venv\\Scripts\\python.exe",
            "args": ["C:\\TuUsuario\\TuUsuario\\ruta\\mentat\\server.py"],
            "env": {
                "GROQ_API_KEY": "gsk_xxxxxxxxxxxxxxxx"
            }
        }
    }
}

Windows: usa doble barra invertida \\ en las rutas. Mac / Linux: usa / normal, por ejemplo /home/usuario/mentat/venv/bin/python.

Reemplaza:

  • TuUsuario por tu usuario del sistema
  • ruta por la carpeta donde clonaste el proyecto
  • gsk_xxxxxxxxxxxxxxxx por tu API Key de Groq

5 — Verifica que el servidor está corriendo

Ctrl + Shift + P → "MCP: List Servers"

Debe aparecer mentat con estado En ejecución y mostrar las 10 tools descubiertas.


💬 Uso en Copilot Chat

Abre Copilot Chat en modo Agent

Ctrl + Alt + I

Cambia el modo a Agent en el selector superior del chat.

Invoca a Mentat

#mentat revisa el archivo server.py
#mentat genera tests para utils.py
#mentat lista los archivos del proyecto
#mentat sugiere un mensaje de commit
#mentat explícame este error: [pega tu error aquí]

En modo Agent también puedes escribir directamente

revisa este código y dime si hay mejoras

Copilot llamará a Mentat automáticamente cuando lo considere necesario.


🖥️ Uso por CLI (Alternativa)

Si prefieres usar Mentat sin VS Code, existe un cliente CLI interactivo:

Ejecutar el CLI

python cli.py

Se abrirá una interfaz interactiva con banner y menús:

███╗   ███╗███████╗███╗   ██╗████████╗ █████╗ ████████╗
████╗ ████║██╔════╝████╗  ██║╚══██╔══╝██╔══██╗╚══██╔══╝
██╔████╔██║█████╗  ██╔██╗ ██║   ██║   ███████║   ██║   
██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   ██╔══██║   ██║   
██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   ██║  ██║   ██║   
╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝   ╚═╝   

MCP Code Assistant  │  Universal Multi-Language Engine

Comandos disponibles

/ayuda              Muestra todos los comandos
/capacidades        Qué puede hacer Mentat
/historial          Muestra la conversación completa
/modelo             Muestra el modelo en uso (Llama 3.3 70B)
/limpiar            Borra el historial y empieza de nuevo
/salir              Cierra Mentat

Ejemplos de uso

> revisa este código: [pega tu código aquí]

> genera tests para mi función calcular()

> explícame este error: [error message]

> ¿cuáles son las mejores prácticas en Python?

Características del CLI

  • ✅ Renderizado de código con sintaxis coloreada
  • ✅ Historial conversacional persistente
  • ✅ Soporte para múltiples lenguajes
  • ✅ Interfaz amigable con paneles y tablas

🔄 Actualizar el servidor

Cada vez que modifiques server.py reinicia el servidor:

Ctrl + Shift + P → "MCP: Restart Server" → mentat

🤝 Apoyo

Si te gusta Mentat y te ha sido útil, ¡tu apoyo es bienvenido!

⭐ Dale una estrella

Si el proyecto te es útil, considéralo merecedor de una estrella ⭐ en GitHub. Nos ayuda a crecer y a que otros desarrolladores descubran Mentat.

👨‍💻 Autor

Creado con ❤️ por Gilberto Galán

Ver o original no GitHub

Bom para

Relacionados