neytor/mcp-clima-colombia repository overview
🌤️ MCP Server Clima Colombia - Docker Image
Servidor MCP (Model Context Protocol) dockerizado para consultar el clima de las principales ciudades de Colombia usando la API de OpenWeatherMap.
🚀 Características
- ✅ 10 ciudades principales de Colombia
- ✅ Clima actual en tiempo real
- ✅ Pronóstico de 5 días
- ✅ Comparación entre múltiples ciudades
- ✅ Imagen Alpine optimizada (~169MB)
- ✅ Usuario no-root para mayor seguridad
- ✅ API key incluida para pruebas inmediatas
🏙️ Ciudades Soportadas
| Región | Ciudades |
|---|---|
| Andina | Bogotá, Medellín, Cali, Bucaramanga, Pereira, Manizales, Pasto |
| Caribe | Barranquilla, Cartagena, Santa Marta |
🐳 Uso Rápido
Ejecutar directamente (con API key incluida)
docker run --rm -i neytor/mcp-clima-colombia:latest
Con tu propia API key de OpenWeatherMap
docker run --rm -i -e OPENWEATHER_API_KEY=tu_api_key neytor/mcp-clima-colombia:latest
Modo interactivo para pruebas
docker run --rm -it neytor/mcp-clima-colombia:latest
🔧 Integración con MCP Clients
Claude Desktop
Agregar a tu archivo de configuración MCP:
{
"mcpServers": {
"climaColombia": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"neytor/mcp-clima-colombia:latest"
],
"env": {
"OPENWEATHER_API_KEY": "tu_api_key_opcional"
}
}
}
}
Continue.dev, Cline, u otros clientes MCP
mcp_servers:
clima_colombia:
command: docker
args:
- run
- --rm
- -i
- neytor/mcp-clima-colombia:latest
env:
OPENWEATHER_API_KEY: "tu_api_key"
🛠️ Herramientas MCP Disponibles
| Herramienta | Descripción | Ejemplo |
|---|---|---|
get_weather | Clima actual de una ciudad | Clima de Bogotá |
get_forecast | Pronóstico de 5 días | Pronóstico de Medellín |
get_multiple_cities_weather | Comparar múltiples ciudades | Comparar Bogotá, Cali y Barranquilla |
🔑 Variables de Entorno
| Variable | Descripción | Por defecto | Requerida |
|---|---|---|---|
OPENWEATHER_API_KEY | API key de OpenWeatherMap | Incluye una de prueba | No* |
NODE_ENV | Entorno de ejecución | production | No |
*Incluye una API key de prueba, pero se recomienda usar la propia para uso intensivo.
📋 Docker Compose
version: '3.8'
services:
mcp-clima:
image: neytor/mcp-clima-colombia:latest
environment:
- OPENWEATHER_API_KEY=${OPENWEATHER_API_KEY}
stdin_open: true
tty: true
restart: unless-stopped
🎯 Casos de Uso
1. Desarrollo de aplicaciones
# Prueba rápida de conectividad
docker run --rm neytor/mcp-clima-colombia:latest
2. Integración en pipelines CI/CD
# GitHub Actions example
- name: Test Climate API
run: |
docker run --rm \
-e OPENWEATHER_API_KEY=${{ secrets.OPENWEATHER_KEY }} \
neytor/mcp-clima-colombia:latest
3. Microservicio en Kubernetes
apiVersion: apps/v1
kind: Deployment
metadata:
name: mcp-clima-colombia
spec:
replicas: 2
selector:
matchLabels:
app: mcp-clima
template:
metadata:
labels:
app: mcp-clima
spec:
containers:
- name: mcp-clima
image: neytor/mcp-clima-colombia:latest
env:
- name: OPENWEATHER_API_KEY
valueFrom:
secretKeyRef:
name: weather-secret
key: api-key
🔍 Debugging y Logs
Ver logs del contenedor
docker run --name mcp-clima -d neytor/mcp-clima-colombia:latest
docker logs mcp-clima
Inspeccionar el contenedor
docker run --rm -it neytor/mcp-clima-colombia:latest sh
Verificar conectividad de API
docker run --rm neytor/mcp-clima-colombia:latest node -e "
const { request } = require('undici');
request('https://api.openweathermap.org/data/2.5/weather?q=bogota&appid=API_KEY')
.then(() => console.log('✅ API conectada'))
.catch(() => console.log('❌ Error de conexión'));
"
📊 Información de la Imagen
- Base:
node:20-alpine - Tamaño: ~169MB
- Arquitectura: linux/amd64
- Usuario:
mcp(no-root) - Puerto expuesto: Ninguno (usa stdio)
- Healthcheck: Incluido
🔄 Versiones Disponibles
| Tag | Descripción | Tamaño |
|---|---|---|
latest | Última versión estable | ~169MB |
v1.0.0 | Versión específica | ~169MB |
🆘 Solución de Problemas
Error: Cannot connect to OpenWeatherMap
# Verificar conectividad
docker run --rm alpine ping -c 3 api.openweathermap.org
Error: Permission denied
# Verificar que Docker esté corriendo
docker info
API key inválida
# Probar con tu propia API key
docker run --rm -e OPENWEATHER_API_KEY=tu_key neytor/mcp-clima-colombia:latest
🔗 Enlaces Relacionados
- Código fuente: GitHub
- Paquete npm: mcp-clima-colombia
- Docker Hub: neytor/mcp-clima-colombia
- Documentación MCP: Model Context Protocol
🤝 Contribuir
¿Encontraste un bug o tienes una mejora? ¡Contribuye al proyecto!
- Fork el repositorio
- Crea una rama para tu feature
- Envía un pull request
📄 Licencia
MIT License - Consulta el LICENSE para más detalles.
Desarrollado por Yonier Gomez 🇨🇴
¿Te gustó este proyecto? ¡Dale una ⭐ en GitHub!
Tag summary
Content type
Image
Digest
sha256:cb56aa705…
Size
50.8 MB
Last updated
about 1 year ago
docker pull neytor/mcp-clima-colombia