MCP (Modelo de Contexto de Protocolo)

Este proyecto es una implementación del Modelo de Contexto de Protocolo (MCP) siguiendo buenas prácticas de desarrollo.

Tecnologías y herramientas

• Node.js - Entorno de ejecución
• TypeScript - Lenguaje de programación con tipado estático
• pnpm - Gestor de paquetes
• ESLint - Linter para identificar problemas en el código
• Prettier - Formateador de código
• Zod - Biblioteca de validación de esquemas

Configuración de calidad de código

El proyecto está configurado con las siguientes herramientas para asegurar la calidad del código:

TypeScript

El archivo `tsconfig.json` incluye configuraciones para:

• Modos estrictos habilitados
• Verificación de tipos avanzada
• Soporte para módulos ES

ESLint

La configuración de ESLint en `eslint.config.mjs` usa el nuevo formato de configuración plana (Flat Config) e incluye:

• Reglas recomendadas para JavaScript y TypeScript
• Plugin de integración con Prettier
• Reglas específicas para buenas prácticas:
  • No usar variables sin usar
  • Preferir const sobre let cuando es posible
  • Siempre usar bloques en estructuras de control
  • Usar comparación estricta (===)

Prettier

La configuración en `.prettierrc` define:

• Uso de comillas simples
• Punto y coma al final de las declaraciones
• Longitud de línea máxima
• Otras configuraciones para un formato consistente

Comandos disponibles

# Iniciar en modo desarrollo
pnpm dev

# Construir el proyecto
pnpm build

# Iniciar en modo producción
pnpm start

# Verificar el código con ESLint
pnpm lint

# Corregir problemas automáticamente con ESLint
pnpm lint:fix

# Formatear el código con Prettier
pnpm format

# Inspeccionar el MCP utilizando el inspector
npx @modelcontextprotocol/inspector npx -y tsx src/main.ts

Estructura del proyecto

• `src/main.ts` - Punto de entrada principal que implementa un servidor MCP con herramientas para consultar el clima
• `src/interfaces.ts` - Definición de interfaces para mejorar la legibilidad y documentación
• `dist/` - Código compilado (generado al ejecutar build)
• `eslint.config.mjs` - Configuración de ESLint en formato moderno (Flat Config)
• `.prettierrc` - Configuración de Prettier
• `tsconfig.json` - Configuración de TypeScript

Buenas prácticas implementadas

• Manejo de tipos: Interfaces para mejorar la legibilidad y documentación
• Manejo de errores: Captura de excepciones con try/catch
• Seguridad: Escape de parámetros URL con `encodeURIComponent`
• Código limpio: Comentarios explicativos, nombres de variables descriptivos
• Linting y formateo: Configuración moderna de ESLint y Prettier para mantener consistencia