ElToque MCP Server

Un servidor MCP (Model Context Protocol) que obtiene precios de USD y EUR del mercado paralelo cubano desde eltoque.com.

Características

• Dos herramientas disponibles:

  • usd-price: Obtiene el precio actual del dólar estadounidense en CUP
  • eur-price: Obtiene el precio actual del euro en CUP

• Extracción de datos en tiempo real desde eltoque.com

• Manejo robusto de errores para solicitudes de red y análisis de HTML

• Dockerizado para fácil despliegue

Uso con Docker

# Construir imagen
npm run docker:build

# Ejecutar contenedor
npm run docker:run

Comandos Docker directos

# Construir
docker build -t eltoque-mcp .

# Ejecutar
docker run -it --rm eltoque-mcp

Desarrollo Local

# Instalar dependencias
npm install

# Ejecutar en modo desarrollo
npm run dev

# Construir
npm run build

# Ejecutar versión compilada
npm start

Integración con Clientes MCP

Para usar este servidor desde un cliente MCP, configura la conexión usando Docker:

{
  "mcpServers": {
    "eltoque": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "eltoque-mcp"]
    }
  }
}

Herramientas Disponibles

usd-price

• Descripción: Devuelve el precio del dólar (USD) en pesos cubanos (CUP)
• Parámetros: Ninguno
• Ejemplo de respuesta: "Precio del dólar hoy: 320 CUP"

eur-price

• Descripción: Devuelve el precio del euro (EUR) en pesos cubanos (CUP)
• Parámetros: Ninguno
• Ejemplo de respuesta: "Precio del euro hoy: 340 CUP"

Arquitectura

• Runtime: Node.js 20 Alpine
• Framework MCP: @modelcontextprotocol/sdk
• Transporte: stdio
• Scraping: Fetch nativo + RegExp para extracción de precios
• Build: TypeScript compilado a JavaScript ES2022

Estructura del Proyecto

├── src/
│   └── index.ts          # Código principal del servidor MCP
├── dist/                 # Código JavaScript compilado
├── Dockerfile           # Configuración Docker
├── package.json         # Dependencias y scripts
└── tsconfig.json        # Configuración TypeScript