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 (: Implementado con FastMCP.

  • 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 (: Cliente inteligente usando Gemini 3 Flash (por defecto).

  • Selección interactiva de modelos al inicio.

  • Narración de pasos antes de ejecutar acciones.

  • Conector stdio para comunicación robusta con el servidor.

Requisitos

• Python 3.10+

• uv (Gestor de paquetes y entornos)

• Gemini API Key

Instalación

1. Clonar el repositorio:

   git clone <repository-url>
   cd mcp_server

2. Configurar el entorno:

   uv venv --python 3.10
   source .venv/bin/activate

3. Instalar dependencias:

   uv pip install -e .

4. Configurar variables de entorno: Crea un archivo .env basado 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.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."

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 .gitignore profesional para evitar subir secretos o entornos virtuales.

Desarrollado con ❤️ para agilizar flujos de trabajo Fullstack.