mcp-weather-connector

Servidor MCP que da a un agente de IA acceso a la previsión del tiempo a través de Open-Meteo, una API pública sin clave ni registro.

Pequeño, a propósito: el repositorio trata sobre cómo está construida la capa de herramientas para un agente, no sobre el tiempo. El tiempo aquí es un pretexto comprensible para mostrar el límite de confianza entre el modelo y el mundo exterior.

Para qué sirve

El Model Context Protocol es un modo de dar a un modelo de lenguaje el derecho a realizar acciones en servicios externos. En cuanto aparece ese derecho, surge la pregunta: ¿qué pasa si el modelo transmite basura a la herramienta y un servicio externo, justo en ese momento, devuelve un 503?

Tres decisiones que se muestran explícitamente en este código:

La entrada desde el modelo no es de confianza. El modelo puede pasar una cadena vacía, una parrafada de diez kilibytes o caracteres de control. Todo eso se filtra en server.py antes de la llamada de red, no en una API externa.

Los errores se distinguen por tipo. Un 4xx no tiene sentido repetirlo: es un error de la solicitud y su repetición no lo resuelve. Un 5xx suele ser un fallo puntual: un solo reintento con una pausa. La lógica está en _get_json y se verifica con pruebas que cuentan las llamadas.

Hacia afuera sale texto, no JSON crudo. El agente no tiene nada que supoñarse ni mucho en lo que equivocarse al contarlo. Una respuesta 200 sin el campo previsto se considera fallo, no una excusa para devolver vacío.

Además: el número de días fuera del rango se corrige al límite, no se trata como un error. Si solicitaron una previsión de 30 días, es más útil entregar siete que derrumbar el diálogo con un mensaje de error.

Related MCP server: open-meteo-mcp-server

Herramientas

locate sirve para un único escenario: cuando el agente no está seguro de cómo se escribe, es mejor consultar el usuario que mostrar en sileno la información del lugar equivocado.

Instalación

pip install -e .

Conexión con Claude Desktop

En claude_desktop_config.json:

{
  "mcpServers": {
    "weather": {
      "command": "mcp-weather"
    }
  }
}

Después de reiniciar la aplicación, las herramientas aparecerán en la lista de elementos disponibles.

Desarrollo

pip install -e ".[dev]"
pytest
ruff check .

Las pruebas cubren lo que sí falla: un vacío y sobreescamado, una cantidad no numérica de días, 4xx sin repetición, 5xx con un reintento, unacceso con éxito al segundo preciso, una respuesta 200 sin carga útil y un código de tiempo desconocido. HTTP se simula con respx, así que no se necesita red en las pruebas.

Estructura

src/mcp_weather/
    client.py    — работа с Open-Meteo: типы, повторы, разбор ответа
    server.py    — MCP-слой: валидация входа и форматирование вывода
tests/
    test_tools.py

El código de red está separado de la capa MCP deliberadamente: el cliente se prueba solo, y las herramientas del agente quedan como una capa fina sobre funciones claras.

Licencia

MIT