mcp-weather-ts

Servidor TypeScript MCP que expone el tiempo de EE. UU. desde la National Weather Service API a hosts como Cursor.

El host inicia node build/index.js y se comunica mediante JSON-RPC a través de stdio. El modelo nunca llama a NWS por sí mismo; llama a las herramientas de este servidor (y puede leer un recurso o usar un prompt).

Cómo funciona MCP (herramientas, recursos, prompts, transporte): docs/create-mcp.readme.md.

Requisitos

• Node.js 22+ (este repositorio usa ESM y fetch)

• npm

• Acceso por red a https://api.weather.gov (solo ubicaciones de EE. UU.)

Related MCP server: weather

Configuración

npm install
npm run build

tsc escribe JavaScript en build/. Cursor debe ejecutar el archivo compilado, no src/index.ts.

Scripts

Montar en Cursor

1. Compila (npm run build).

2. Añade .cursor/mcp.json en este proyecto:

{
  "mcpServers": {
    "weather": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/build/index.js"]
    }
  }
}

Para todos los proyectos de Cursor, usa %USERPROFILE%\.cursor\mcp.json y una ruta completa a build\index.js en lugar de ${workspaceFolder}.

3. Abre Customize → MCP (o Cursor Settings → MCP) y activa weather.

4. Después de cambiar src/, vuelve a ejecutar npm run build y desactiva/activa el servidor para que Cursor reinicie el proceso.

No uses console.log después de que el servidor se conecte: stdout es el canal de MCP. Usa console.error para los logs.

Qué puedes invocar

Herramientas

El modelo (o tú, preguntándole en el chat de Agent) invoca estas herramientas con tools/call.

Ejemplo de chat:

• «¿Hay alertas meteorológicas para CA?»

• «Pronóstico para 39.7456, -97.0892»

Ejemplos de argumentos:

{ "state": "CA" }

{ "latitude": 39.7456, "longitude": -97.0892 }

Recurso

Pídele al agente que lea weather://nws-guide, o usa resources/read en un cliente.

Prompt

En Cursor, elige el prompt Check weather y rellena place.

Estructura del proyecto

src/index.ts              Create McpServer, register, connect stdio
src/tools.ts              get_alerts, get_forecast, test_tool
src/resources.ts          weather://nws-guide
src/prompts.ts            check_weather
src/weather-api-call.ts   NWS fetch + types + alert formatting
src/createTransport.ts    StdioServerTransport + connect
tests/weather-api-call.test.ts
docs/create-mcp.readme.md How to design MCP servers

Orden de inicio en src/index.ts:

1. new McpServer({ name: "weather", version: "1.0.0" })

2. registerWeatherTools / registerWeatherResources / registerWeatherPrompts

3. connectStdioTransport(server)

Notas sobre NWS

• Los pronósticos no están en /points/{lat},{lon}/forecast. Carga /points/{lat},{lon} (cuatro decimales) y luego sigue properties.forecast o properties.forecastHourly.

• NWS requiere una cabecera User-Agent (configurada en weather-api-call.ts).

• La cobertura es de EE. UU. (y algunos territorios). Otras coordenadas suelen fallar.

Solución de problemas

Cursor: Output → MCP Logs.

Licencia

ISC