baleada-mcp-server

amenocal/baleada-mcp-server

3.1

If you are the rightful owner of baleada-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Baleada MCP Server is a Honduran culinary-themed Model Context Protocol server focused on the traditional dish, baleadas.

Tools
4
Resources
0
Prompts
0

Baleada MCP Server 🌯🇭🇳

Un servidor MCP hondureño especializado en baleadas tradicionales. Este proyecto convierte el template de mcp-go-starter en una experiencia culinaria hondureña auténtica.

¿Qué es este servidor?

Este servidor MCP (Model Context Protocol) está dedicado a las baleadas, el platillo más emblemático de Honduras. Ofrece herramientas interactivas para:

  • 🇭🇳 Saludos hondureños auténticos
  • 🌯 Creación de baleadas personalizadas
  • 🎲 Generación de baleadas aleatorias
  • 🥤 Recomendaciones de bebidas tradicionales
  • 📚 Información cultural e histórica

Inicio Rápido

Modo Local (stdio)

  1. Ejecutar el servidor desde /vscode/mcp.json

El servidor está configurado para funcionar desde el primer momento usando el archivo mcp.json incluido.

  1. Ejecutar el servidor (modo desarrollo) usando el script:
./script/go-run
  1. O construir y ejecutar el servidor manualmente:
go build -o baleada-mcp-server ./cmd/mcp && ./baleada-mcp-server stdio

Modo Remoto (HTTP/SSE)

¡Ahora puedes ejecutar el servidor Baleada MCP como un servicio y conectarte desde otra instancia de VS Code!

  1. Ejecutar el servidor en modo HTTP:
./baleada-mcp-server http --addr localhost:8080
  1. Ejecutar el servidor en modo SSE:
./baleada-mcp-server sse --addr localhost:8080
  1. Conectar desde VS Code usando transportes de red:
  • Copia .vscode/mcp-http.json o .vscode/mcp-sse.json a tu configuración de VS Code
  • El servidor estará disponible en http://localhost:8080/baleada (HTTP) o http://localhost:8080/baleada/sse (SSE)

Variables de Entorno

  • BALEADA_GREETING: Saludo a usar (por defecto: ¡Hola)
  • BALEADA_SECRET: Valor secreto para demostración (por defecto: Baleadas)
  • BALEADA_ADDR: Dirección del servidor para transportes de red (por defecto: localhost:8080)

Herramientas Disponibles

🇭🇳 saludo_hondurenio

Da un saludo típico hondureño personalizado según el momento del día.

Parámetros:

  • nombre (requerido): Nombre de la persona a saludar
  • momento (opcional): "mañana", "tarde", "noche"

🌯 crear_baleada

Crea una baleada hondureña con ingredientes específicos.

Parámetros:

  • ingredientes (requerido): Lista de ingredientes para la baleada
  • extra_tortilla (opcional): ¿Quieres tortilla extra gruesa?

🎲 baleada_aleatoria

Genera una baleada hondureña con ingredientes aleatorios.

Parámetros:

  • estilo (opcional): "simple", "completa", "gourmet"

🥤 recomendar_bebida

Recomienda una bebida hondureña para acompañar tu baleada.

Parámetros:

  • ingredientes_baleada (requerido): Ingredientes de tu baleada
  • momento (opcional): "desayuno", "almuerzo", "cena", "merienda"

Prompts Disponibles

📖 info_baleadas

Proporciona información detallada sobre las baleadas hondureñas.

Argumentos:

  • nivel: "básico", "completo", "historia"

🧑‍🍳 receta_baleada

Proporciona una receta detallada para hacer baleadas caseras.

Argumentos:

  • tipo: "tortillas", "frijoles", "completa"

👋 saludo_catracho

Saludo tradicional hondureño con espíritu de baleadas.

Argumentos:

  • nombre: Nombre de la persona a saludar

Recursos Disponibles

📚 docs://baleadas-info

Guía completa en markdown sobre las baleadas: historia, ingredientes, cultura y tradiciones hondureñas.

Ejemplos de Uso

Ejemplo: Usar Transportes de Red

Paso 1: Ejecutar el servidor en una terminal

# Compilar el servidor
go build -o baleada-mcp-server ./cmd/mcp

# Ejecutar en modo HTTP
./baleada-mcp-server http --addr localhost:8080

Paso 2: Configurar VS Code en otra instancia

Crear un archivo mcp.json en tu carpeta .vscode con:

{
  "servers": {
    "baleada-mcp-server": {
      "transport": {
        "type": "http",
        "url": "http://localhost:8080/baleada"
      }
    }
  }
}

O para SSE:

{
  "servers": {
    "baleada-mcp-server": {
      "transport": {
        "type": "sse",
        "url": "http://localhost:8080/baleada/sse"
      }
    }
  }
}

Paso 3: ¡Listo!

Ahora puedes usar el servidor Baleada desde cualquier instancia de VS Code que apunte a la URL del servidor.

Ejemplo: Crear una Baleada Tradicional

Solicitud:

{
  "method": "tools/call",
  "params": {
    "name": "crear_baleada",
    "arguments": {
      "ingredientes": ["frijoles refritos", "queso fresco", "crema", "huevos revueltos"],
      "extra_tortilla": true
    }
  },
  "id": 1,
  "jsonrpc": "2.0"
}

Respuesta:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "🌯 ¡Baleada Lista!\n\nBase: tortilla de harina extra gruesa\nIngredientes:\n- frijoles refritos\n- queso fresco\n- crema\n- huevos revueltos\n\n✅ ¡Perfecto! Tu baleada tiene los ingredientes tradicionales.\n\n¡Que la disfrutes! 🇭🇳"
    }]
  }
}

Ejemplo: Saludo Hondureño

Solicitud:

{
  "method": "tools/call",
  "params": {
    "name": "saludo_hondurenio",
    "arguments": {
      "nombre": "María",
      "momento": "mañana"
    }
  },
  "id": 2,
  "jsonrpc": "2.0"
}

Respuesta:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "¡Buenos días, María! ¿Cómo amaneciste?\n\n¡Perfecto momento para una baleadita! 🌯"
    }]
  }
}

Acerca de las Baleadas 🌯

Las baleadas son un platillo tradicional hondureño muy popular. Son tortillas de harina de trigo gruesas que se rellenan típicamente con:

  • Frijoles refritos (ingrediente básico)
  • Queso fresco rallado (generalmente queso seco hondureño)
  • Crema (crema agria hondureña)

Y pueden llevar ingredientes adicionales como:

  • Huevos revueltos
  • Aguacate
  • Carne (pollo, chorizo, carne asada)
  • Plátano frito

Las baleadas son consideradas una comida rápida y económica en Honduras, perfectas para el desayuno, almuerzo o cena. Se doblan por la mitad para comerlas más fácilmente.

Historia

Las baleadas nacieron en La Ceiba en los años 1960s, gracias a Doña Teresa de Flores. El nombre viene del béisbol - cuando una pelota era "baleada" (golpeada fuertemente), los fanáticos corrían a comprar estas deliciosas tortillas.

En 2019, las baleadas fueron declaradas oficialmente "Patrimonio Cultural Gastronómico de Honduras".

Integración con VS Code

Modo Local (stdio)

  • .vscode/mcp.json está preconfigurado para desarrollo rápido.
  • Asegúrate de usar la ruta completa al script en el campo command para mejores resultados.

Modo Remoto (HTTP/SSE)

  • .vscode/mcp-http.json - Configuración para transporte HTTP
  • .vscode/mcp-sse.json - Configuración para transporte SSE
  • Ideal para conectar múltiples instancias de VS Code al mismo servidor
  • Útil para desarrollo en equipo o configuraciones distribuidas

Transportes de Red Disponibles

HTTP Transport

./baleada-mcp-server http --addr localhost:8080
  • Endpoint: http://localhost:8080/baleada
  • Ventajas: Protocolo estándar HTTP, fácil de debuggear
  • Uso: Ideal para la mayoría de casos de uso

SSE Transport (Server-Sent Events)

./baleada-mcp-server sse --addr localhost:8080
  • Endpoint: http://localhost:8080/baleada/sse
  • Ventajas: Eventos en tiempo real, conexión persistente
  • Uso: Ideal para aplicaciones que requieren notificaciones push

Stdio Transport (Local)

./baleada-mcp-server stdio
  • Uso: Desarrollo local, ejecución desde VS Code directamente
  • Ventajas: Configuración cero, ideal para desarrollo rápido

Codespaces/Devcontainer

Se proporciona un devcontainer básico para GitHub Codespaces con herramientas de Go habilitadas.

¡ Que vivan las baleadas! 🇭🇳🌯

Para más detalles técnicos, consulta el README del mcp-go.