README.md
MCP implementation for fullstack development with Python and Next.js
Professional MCP Repository (Python & Next.js)
Este repositorio contiene una implementación profesional de Model Context Protocol (MCP) diseñada para asistir en el desarrollo de aplicaciones Fullstack (Python y Next.js).
Características
- MCP Server (
server.py): Implementado conFastMCP.read_code: Lectura segura de archivos (.py, .ts, .tsx, etc).write_code: Escritura y actualización de código.run_terminal: Ejecución de comandos con captura de logs.list_models: Descubrimiento de modelos Gemini disponibles.notify_dev: Notificaciones nativas en Linux (KDE).
- Utilidades:
check_models.py: Script independiente para verificar tu API Key y modelos.- MCP Agent (
agent.py): Cliente inteligente usando Gemini 3 Flash (por defecto). - Selección interactiva de modelos al inicio.
- Narración de pasos antes de ejecutar acciones.
- Conector
stdiopara comunicación robusta con el servidor.
Requisitos
- Python 3.10+
uv(Gestor de paquetes y entornos)- Gemini API Key
Instalación
Clonar el repositorio:
git clone <repository-url> cd mcp_serverConfigurar el entorno:
uv venv --python 3.10 source .venv/bin/activateInstalar dependencias:
uv pip install -e .Configurar variables de entorno: Crea un archivo
.envbasado en.env.example:cp .env.example .env # Edita .env y añade tu GEMINI_API_KEY
Uso
Iniciar el Agente
El agente iniciará automáticamente el servidor MCP en segundo plano.
uv run agent.py
Ejemplo de Interacción
- "Léeme el archivo server.py y explica qué hace cada herramienta."
- "Crea un componente de Next.js llamado
UserProfile.tsxque reciba un nombre y un email." - "Ejecuta
ls -lay dime qué archivos hay en la raíz." - "Envíame una notificación diciendo que el despliegue ha terminado."
Notas de Desarrollo
- El servidor está configurado para ejecutarse mediante
uv run server.py, lo que garantiza que las dependencias estén siempre actualizadas. - Si simplemente pulsas Enter, usará por defecto
gemini-3-flash-preview(rápido y eficiente). - Se ha incluido un
.gitignoreprofesional para evitar subir secretos o entornos virtuales.
Desarrollado con ❤️ para agilizar flujos de trabajo Fullstack.
Tools (5)
read_codeLectura segura de archivos (.py, .ts, .tsx, etc).write_codeEscritura y actualización de código.run_terminalEjecución de comandos con captura de logs.list_modelsDescubrimiento de modelos Gemini disponibles.notify_devNotificaciones nativas en Linux (KDE).Environment Variables
GEMINI_API_KEYrequiredAPI Key for Gemini models used by the agentConfiguration
claude_desktop_config.json
{
"mcpServers": {
"python-fullstack": {
"command": "uv",
"args": ["run", "server.py"],
"env": {
"GEMINI_API_KEY": "your_api_key_here"
}
}
}
}Try it
→Léeme el archivo server.py y explica qué hace cada herramienta.
→Crea un componente de Next.js llamado UserProfile.tsx que reciba un nombre y un email.
→Ejecuta ls -la y dime qué archivos hay en la raíz.
→Envíame una notificación diciendo que el despliegue ha terminado.