# 🚀 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.
---
## 🛠️ Requisitos Previos
Antes de comenzar, asegúrate de tener instalado:
* **Python 3.13** o superior.
* **[uv](https://github.com/astral-sh/uv)**: Un gestor de paquetes de Python extremadamente rápido.
---
## 📦 Instalación
1. **Clonar el repositorio:**
```bash
git clone https://github.com/TUSUARIO/mcp-server.git
cd mcp-server
```
2. **Instalar dependencias:**
Utilizando `uv` para sincronizar el entorno virtual:
```bash
uv sync
```
---
## ⚙️ Configuración
1. Crea un archivo `.env` en la raíz del proyecto basándote en el siguiente ejemplo:
```ini
# .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:
```bash
uv run main.py
```
El servidor estará disponible en: `http://0.0.0.0:8000`
### Endpoints Disponibles
| Tipo | Nombre | Descripción |
| :--- | :--- | :--- |
| **Tool** | `send_email` | Envía correos HTML vía SMTP. |
| **Prompt** | `detect_action` | Clasifica la intención del usuario (saludo/info). |
| **Prompt** | `client_info` | Extrae nombre y email de un texto. |
| **Prompt** | `welcome_email` | Genera el cuerpo de un email de bienvenida. |
---
## 📂 Estructura del Proyecto
```text
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**
---
<p align="center">
<sub>Desarrollado con ❤️ y Python</sub>
</p>
