readme.md•2.67 kB
# 🌤️ 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](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.