🌤️ Weather Server - MCP Implementation (Node.js)

🧩 Servidor MCP de Clima e Historial – Versión Final

Este proyecto implementa un servidor MCP (Model Context Protocol) en Node.js que permite a modelos de lenguaje (como Claude o GPT) obtener información climática en tiempo real y consultar un historial local de búsquedas, utilizando APIs abiertas y almacenamiento local en JSON.

🌐 1. ¿Qué es el MCP (Model Context Protocol)?

El Model Context Protocol (MCP) es un protocolo abierto desarrollado por Anthropic y la comunidad de IA para conectar modelos de lenguaje con fuentes de información externas y herramientas locales de manera segura y estructurada.

En términos simples:

El MCP permite que un modelo de IA hable con tu aplicación, acceda a datos o ejecute funciones, sin exponer directamente tu código ni tus APIs privadas.

Related MCP server: Weather MCP Server

⚙️ 2. Cómo funciona el MCP

Un MCP Server es una aplicación que expone:

• 🛠️ Tools (herramientas) → Acciones que el modelo puede ejecutar (por ejemplo: get-weather, get-history).

• 📚 Resources (recursos) → Archivos o datos a los que el modelo puede acceder (por ejemplo: weather-codes.json).

• 🔔 Events (opcional) → Notificaciones o flujos de datos en tiempo real.

El modelo de IA actúa como cliente MCP, que se comunica con tu servidor usando un canal seguro (en este caso, stdio, o entrada/salida estándar).

🧩 3. Descripción del proyecto (main.ts)

El archivo main.ts define un servidor MCP en Node.js que ofrece dos herramientas y un recurso:

🛠️ Herramienta 1: get-weather

Propósito: Obtener el clima actual de una ciudad.

Flujo:

1. Busca la ciudad en la Geocoding API de Open Meteo para obtener coordenadas.

2. Consulta los datos del clima actual en la Weather API de Open Meteo.

3. Guarda la consulta (ciudad, coordenadas, temperatura, fecha) en un archivo local history.json.

4. Devuelve al modelo una respuesta simplificada con temperatura y humedad.

📄 Ejemplo de respuesta:

{
  "city_searched": "Santiago",
  "current_temperature_c": 22.5,
  "relative_humidity_percent": 48,
  "weather_code": 1
}

🧠 **Arquitectura conceptual**

          ┌──────────────────────────────┐
          │      Modelo de IA (Cliente)  │
          │    (Claude, GPT, etc.)       │
          └─────────────┬────────────────┘
                        │
            JSON (via STDIO / MCP)
                        │
          ┌─────────────┴────────────────┐
          │     Tu Servidor MCP (Node)   │
          │ ├── Tool: get-weather        │
          │ ├── Tool: get-history        │
          │ └── Resource: weather-codes  │
          └─────────────┬────────────────┘
                        │
          ┌─────────────┴────────────────┐
          │     APIs externas (OpenMeteo)│
          │     Archivos locales (.json) │
          └──────────────────────────────┘


📦 **Instalación y ejecución**

# Clonar el repositorio
git clone https://github.com/IAcademico/weather-mcp-server.git
cd weather-mcp-server

# Instalar dependencias
npm install

# Ejecutar el servidor MCP
npm run start

📁 **Estructura del proyecto**

📦 weather-mcp-server
 ┣ 📂 .vscode/
 ┣ 📂 node_modules/
 ┣ 📂 project_scanners/
 ┣ 📜 main.ts
 ┣ 📜 history.json
 ┣ 📜 weather-codes.json
 ┗ 📜 README.md