# 🌤️ MCP Weather Tool

Un servidor MCP (Model Context Protocol) simple que permite consultar el clima de cualquier ciudad del mundo.

## ✨ Características

- 🔍 **Búsqueda por ciudad**: Encuentra automáticamente las coordenadas de cualquier ciudad
- 🌡️ **Información del clima**: Temperatura, precipitación, estado del día y lluvia
- 🚀 **Integración con Claude**: Funciona perfectamente en Claude Desktop
- 📍 **Coordenadas precisas**: Usa APIs de geocoding y meteorología confiables

## 🛠️ Instalación

1. **Clona el repositorio:**
```bash
git clone https://github.com/fernandezAlex/mcp-weather-tool.git
cd mcp-weather-tool
```

2. **Instala las dependencias:**
```bash
npm install
```

3. **Compila el proyecto:**
```bash
npx tsc
```

## ⚙️ Configuración en Claude Desktop

Añade esto a tu `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mcp-test": {
      "command": "node",
      "args": ["/ruta/completa/a/mcp-weather-tool/dist/main.js"]
    }
  }
}
```

## 🚀 Uso

1. **Reinicia Claude Desktop**
2. **Usa la herramienta**: "¿Cuál es el clima en Madrid?"
3. **Disfruta** de la información meteorológica en tiempo real

## 📡 APIs Utilizadas

- **Geocoding**: [Open-Meteo Geocoding API](https://open-meteo.com/en/docs/geocoding-api)
- **Weather**: [Open-Meteo Weather API](https://open-meteo.com/en/docs)

## 🏗️ Estructura del Proyecto

```
mcp-weather-tool/
├── main.ts          # Código fuente del servidor MCP
├── dist/            # Archivos compilados
├── package.json     # Dependencias del proyecto
└── README.md        # Este archivo
```

## 🔧 Tecnologías

- **TypeScript** - Lenguaje principal
- **Node.js** - Runtime de JavaScript
- **MCP SDK** - Protocolo de comunicación con Claude
- **Fetch API** - Llamadas HTTP a APIs externas

## 👨‍💻 Autor

**Alex Fernández** - Frontend Developer & Designer

- 🌐 [GitHub](https://github.com/fernandezAlex)
- 🔗 [LinkedIn](https://linkedin.com/in/alexfernandezarroyo)
- 🌍 [Portfolio](https://afacreations.com)

## 📝 Licencia

MIT License - Libre para uso personal y comercial

---

**Desarrollado con ❤️ por [@fernandezAlex](https://github.com/fernandezAlex) para la comunidad de Claude**