🚀 MCP Server - Model Context Protocol

MCP Server es una implementación robusta y eficiente de un servidor compatible con el Model Context Protocol (MCP). Diseñado para extender las capacidades de los Modelos de Lenguaje (LLMs), este servidor proporciona herramientas para el envío de correos electrónicos y prompts inteligentes para la detección de intenciones y gestión de datos de clientes.

✨ Características Principales

• 📧 Integración SMTP Completa: Envío de correos electrónicos enriquecidos (HTML) a través de Gmail u otros proveedores SMTP.

• 🧠 Prompts Inteligentes:

  • Detección de Intención: Clasifica mensajes de usuarios automáticamente.

  • Extracción de Información: Identifica datos clave como nombres y correos.

  • Generación de Contenido: Crea emails de bienvenida personalizados dinámicamente.

• 🔒 Seguridad Primero: Gestión de credenciales mediante variables de entorno y validación de tokens.

• ⚡ Alto Rendimiento: Construido sobre FastAPI y FastMCP para una latencia mínima.

Related MCP server: phison-mail-mcp

🛠️ Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

• Python 3.13 o superior.

• uv: Un gestor de paquetes de Python extremadamente rápido.

📦 Instalación

1. Clonar el repositorio:

   git clone https://github.com/TUSUARIO/mcp-server.git
   cd mcp-server

2. Instalar dependencias:

   Utilizando uv para sincronizar el entorno virtual:

   uv sync

⚙️ Configuración

1. Crea un archivo .env en la raíz del proyecto basándote en el siguiente ejemplo:

   # .env
   EMAIL_USER=tu_correo@gmail.com
   EMAIL_PASS=tu_contraseña_de_aplicacion

   Nota: Para Gmail, debes usar una "Contraseña de Aplicación" si tienes la verificación en dos pasos activada.

🚀 Uso

Para iniciar el servidor en modo desarrollo:

uv run main.py

El servidor estará disponible en: http://0.0.0.0:8000

Endpoints Disponibles

📂 Estructura del Proyecto

mcp-server/
├── main.py              # Punto de entrada y lógica del servidor
├── pyproject.toml       # Definición de dependencias
├── .gitignore           # Archivos ignorados por git
├── .env                 # Variables de entorno (NO COMMITEAR)
└── README.md            # Documentación del proyecto

🤝 Contribución

¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía un pull request para mejoras o correcciones.

1. Haz un Fork del proyecto.

2. Crea tu rama de funcionalidad (git checkout -b feature/AmazingFeature).

3. Haz Commit de tus cambios (git commit -m 'Add some AmazingFeature').

4. Push a la rama (git push origin feature/AmazingFeature).

5. Abre un Pull Request.

👤 Autor

MKevyn