# 🌤️ Weather MCP Server (Tutorial)

![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
![Node.js](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge&logo=node.js&logoColor=white)
![MCP](https://img.shields.io/badge/MCP-Standard-purple?style=for-the-badge)

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](https://open-meteo.com/) para obtener datos climáticos en tiempo real.

📺 **[VER EL TUTORIAL COMPLETO EN YOUTUBE](https://www.youtube.com/watch?v=K1LanTSBlxo)**

## 🚀 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:
   ```bash
   git clone [https://github.com/acenaga/mcpWeather.git](https://github.com/acenaga/mcpWeather.git)
   cd mcpWeather
```

2. Instala las dependencias:
```bash
    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
2. Agrega tu servidor a la lista mcpServers. Asegúrate de poner la ruta absoluta a tu carpeta build/index.js.

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

3. 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:
```Bash
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.