Open-Meteo MCP Server

Un pequeño servidor MCP (Model Context Protocol) que da a un asistente de IA como Claude la capacidad de consultar datos meteorológicos reales — condiciones actuales y pronósticos — envolviendo la API gratuita de Open-Meteo. No se requiere clave de API.

Construido como un proyecto de aprendizaje para entender cómo funcionan los servidores MCP de principio a fin: definir herramientas, ejecutarlas localmente y conectarlas a un cliente de IA real.

Qué hace

Una vez conectado a un cliente compatible con MCP (como Claude), expone tres herramientas:

Así, una persona puede preguntarle a un asistente «¿qué tiempo hará en Lisboa mañana?» y el asistente llamará él mismo a estas herramientas para averiguarlo y responder — no está preprogramado con datos meteorológicos, los obtiene en tiempo real.

Related MCP server: Weather MCP Server

Cómo está construido

• src/server.ts — define las tres herramientas y cómo cada una llama a la API de Open-Meteo. Este es el «cerebro» real del servidor.

• src/index.ts — ejecuta el servidor a través de stdio (entrada/salida estándar). Este es el transporte que usan las herramientas de desarrollo locales como el MCP Inspector y las aplicaciones de escritorio que lanzan el servidor como subproceso.

• src/http.ts — ejecuta el mismo servidor a través de Streamable HTTP, de modo que se puede acceder a él por red — p. ej. alojado en algún sitio o desde un cliente basado en navegador. Esto es lo que hace posible hacer una demo sin instalar nada localmente.

Ambos puntos de entrada comparten las mismas definiciones de herramientas en server.ts, de modo que la lógica real vive en un solo lugar.

Cómo ejecutarlo

npm install
npm run build

Modo local/stdio (para herramientas que lanzan el servidor como subproceso):

npm start

Modo HTTP (para conectar un cliente remoto, p. ej. a través de un puerto reenviado de Codespaces o un proveedor de alojamiento):

node build/http.js

Esto inicia un servidor HTTP simple en el puerto 3000 (configurable mediante PORT) con un único endpoint MCP en POST /mcp, además de una comprobación GET /health.

Probarlo sin ningún cliente

El modo CLI del MCP Inspector es la forma más rápida de probarlo directamente desde una terminal, sin necesidad de navegador:

# See what tools are available
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

# Actually call one
npx @modelcontextprotocol/inspector --cli node build/index.js \
  --method tools/call --tool-name geocode_location --tool-arg name=London

Conectarlo a un asistente de IA

• Claude Desktop / Claude Code: apunta a build/index.js como servidor MCP stdio en la configuración del cliente.

• Conectores personalizados de Claude.ai: apunta a la URL /mcp de una instancia HTTP en ejecución (requiere un plan que permita conectores personalizados).

• API de Anthropic directamente: pasa la URL /mcp en el parámetro mcp_servers de una solicitud /v1/messages — esto permite que cualquier aplicación o página personalizada use las herramientas sin necesidad de un cliente MCP previamente construido.

Notas para ampliarlo

Open-Meteo tiene muchas más variables y endpoints de los que usa este proyecto (calidad del aire, pronósticos marinos, datos históricos/de archivo, ensembles). Para añadir más, sigue el patrón de una herramienta existente en src/server.ts — registra un nuevo bloque server.tool(...) con su propio esquema de entrada y la solicitud a Open-Meteo.

Datos © Open-Meteo.com, CC BY 4.0.