🌤️ 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:

Busca la ciudad en la Geocoding API de Open Meteo para obtener coordenadas.
Consulta los datos del clima actual en la Weather API de Open Meteo.
Guarda la consulta (ciudad, coordenadas, temperatura, fecha) en un archivo local history.json.
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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables real-time weather information retrieval and local search history management using Open Meteo APIs. Allows users to get current weather data for any city and access their weather query history through natural language.

Weather MCP Server

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

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

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

⚙️ 2. Cómo funciona el MCP

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

🛠️ Herramienta 1: `get-weather`

New MCP Servers

MCP directory API

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

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

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

⚙️ 2. Cómo funciona el MCP

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

🛠️ Herramienta 1: get-weather

New MCP Servers

MCP directory API

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

🛠️ Herramienta 1: `get-weather`