# 🌤️ 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.**

---

## ⚙️ 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:**
```json
{
  "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