mcpField
M
MCP (Modelo de Contexto de Protocolo)

MCP (Modelo de Contexto de Protocolo)

Local
github.com/MiguelAngelGutierrezMayaMaps & Travel0Updated 77w ago
Repository

About MCP (Modelo de Contexto de Protocolo)

A local MCP server built with Node.js and TypeScript that provides weather lookup tools. It also includes typed interfaces, error handling, and code-quality configuration.

Key features

  1. 01Weather lookup tools
  2. 02TypeScript interfaces
  3. 03Exception handling
  4. 04ESLint and Prettier configuration

Use cases

  1. 01Look up weather from an MCP client
  2. 02Develop a local MCP server in TypeScript

MCP support

The server exposes weather lookup tools to MCP clients.

#local-mcp#weather-fetcher#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "local": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.