🌤️ Servidor MCP de Clima (Node.js)

Servidor remoto MCP (Model Context Protocol) implementado con Node.js / Express. Expone la herramienta get_weather a través de Streamable HTTP transport, lo que permite a clientes MCP como Claude Code consultar en tiempo real el clima actual de cualquier ciudad.

Los datos meteorológicos provienen de wttr.in — gratuito, sin registro y sin API key.

✨ Características

• 🛰️ Servicio MCP remoto: implementado con el SDK oficial @modelcontextprotocol/sdk mediante Streamable HTTP, con soporte para modos de respuesta JSON y SSE

• 🌆 Soporte de ciudades globales: basta con pasar el nombre de la ciudad (p. ej. Beijing, Tokyo, Paris) para consultar el clima local

• 🔌 Gestión completa de sesiones: genera/valida automáticamente el Mcp-Session-Id, con soporte para crear, reutilizar y cerrar sesiones (DELETE)

• 🧩 Un solo archivo listo para usar: sin base de datos, sin archivos de configuración, basta con un server.js para arrancar

Related MCP server: MCP Weather Server — Demo

📦 Requisitos del entorno

• Node.js ≥ 18 (incluye fetch integrado, sin dependencias adicionales)

🚀 Inicio rápido

# 1. 安装依赖
npm install

# 2. 启动服务(默认端口 3000)
npm start

# 后台运行(日志写入 logs/server.log)
npm run start:bg

Una vez iniciado el servicio, la dirección es:

http://localhost:3000/mcp

Scripts habituales

🔌 Configuración del cliente MCP

En Claude Code u otro cliente MCP compatible con Streamable HTTP, registra el servicio como servidor MCP remoto.

Claude Code

Añádelo desde la lista de servidores MCP (/mcp → Añadir → HTTP):

{
  "type": "http",
  "url": "http://localhost:3000/mcp"
}

Mediante archivo de configuración JSON

{
  "mcpServers": {
    "weather": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🧰 Herramientas proporcionadas

get_weather

Obtiene el clima actual de la ciudad especificada.

Parámetros

Ejemplo de respuesta

当前 Beijing 的天气是晴(Sunny),温度 28°C(体感 30°C),湿度 45%,风速 12 km/h。

⚙️ Notas de implementación

• Aislamiento de sesiones: cada sesión mantiene una instancia independiente de Server + transport (el método connect() del SDK solo admite un transport), asociada mediante la cabecera Mcp-Session-Id.

• Flujo de nueva sesión: una POST sin Mcp-Session-Id se considera una solicitud de inicialización; el servidor genera un ID de sesión y lo devuelve en la cabecera de respuesta Mcp-Session-Id (expuesta explícitamente a los clientes de navegador mediante exposedHeaders de CORS).

• Gestión de compatibilidad: las solicitudes de sondeo GET SSE sin ID de sesión mantienen un flujo SSE abierto (en lugar de devolver 404/400), de modo que clientes como Claude Code puedan continuar con el flujo de inicialización POST.

• Devolución de errores fiable: cuando falla la llamada a la API meteorológica, se devuelve un resultado con isError: true en lugar de hacer fallar toda la solicitud.

🗂️ Estructura del proyecto

.
├── server.js          # 全部服务逻辑(单文件)
├── package.json       # 项目配置与脚本
├── logs/              # 运行时日志(已被 .gitignore 忽略)
└── LICENSE            # MIT 许可证

📄 Licencia

MIT