Weather MCP Server (mcpweather)

🌤️ Weather MCP Server (Tutorial)

Este repositorio contiene el código fuente del servidor MCP (Model Context Protocol) desarrollado en el tutorial de YouTube. Este servidor permite conectar Claude Desktop con la API pública de Open-Meteo para obtener datos climáticos en tiempo real.

📺 VER EL TUTORIAL COMPLETO EN YOUTUBE

🚀 Características

• Servidor MCP Básico: Implementación limpia usando el SDK oficial de TypeScript.
• Herramienta (Tool) personalizada: get-weather que acepta ciudad y código de país.
• Integración API Real: Conexión con Open-Meteo (sin necesidad de API Key).
• Validación de datos: Uso de Zod para validar esquemas.

🛠️ Requisitos

• Node.js (v18 o superior)
• Claude Desktop App instalado

📦 Instalación

1. Clona este repositorio:

   git clone 
   cd mcpWeather

1. Instala las dependencias:

    npm install

⚙️ Configuración en Claude Desktop

Para usar este servidor en Claude, debes editar tu archivo de configuración.

1. Abre el archivo de configuración de Claude:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Agrega tu servidor a la lista mcpServers. Asegúrate de poner la ruta absoluta a tu carpeta build/index.js.

   {
    "mcpServers": {
        "weather-server": {
        "command": "node",
        "args": [
            "/RUTA/ABSOLUTA/HACIA/TU/PROYECTO/build/index.js"
        ]
        }
    }
    }

1. Reinicia Claude Desktop. Deberías ver un icono de "enchufe" 🔌 indicando que el servidor está conectado.

🐛 Debugging (MCP Inspector)

Si quieres probar el servidor sin usar Claude, puedes usar el Inspector oficial de MCP:

npx @modelcontextprotocol/inspector node build/index.js

Esto abrirá una interfaz web donde puedes probar las herramientas manualmente.

🤝 Contribuir

¡Las PRs son bienvenidas! Si tienes ideas para mejorar este ejemplo o agregar más herramientas climáticas, siéntete libre de contribuir.

Desarrollado por Carlos Ferrer "Acenaga" Si este código te sirvió, considera dejar una ⭐ en el repo y suscribirte al canal.