mcpapp1 — Servidor MCP meteorológico

Un pequeño servidor Model Context Protocol que expone alertas meteorológicas de EE. UU. en vivo a clientes MCP como Claude Desktop, Claude Code y Cursor.

Los datos provienen de la National Weather Service API, que es gratuita y no requiere clave de API.

Qué expone

Related MCP server: Weather Alert & Forecast MCP Tool

Requisitos

• Python 3.13+

• uv

Configuración

git clone https://github.com/eyosiasbisrat/mcpapp1.git
cd mcpapp1
uv sync

Ejecución

Ejecuta el servidor directamente a través de stdio:

uv run server/weather.py

O mediante la CLI de MCP:

uv run mcp run server/weather.py

Inspecciónalo de forma interactiva en el MCP Inspector:

uv run mcp dev server/weather.py

Un servidor MCP se comunica mediante JSON-RPC a través de stdin/stdout, por lo que ejecutarlo a mano simplemente espera en silencio la entrada. Eso es lo esperado — normalmente un cliente lo inicia por ti.

Conectar un cliente

Claude Code / Cursor

Ambas configuraciones ya están incluidas en el repositorio y usan rutas relativas, por lo que funcionan después de uv sync sin necesidad de ediciones:

• .mcp.json — Claude Code

• .cursor/mcp.json — Cursor

Recarga la ventana del editor y aprueba el servidor cuando se te solicite.

Claude Desktop

uv run mcp install server/weather.py

A continuación, cierra Claude Desktop por completo — incluido el icono de la bandeja, ya que cerrar la ventana lo deja en ejecución — y vuelve a abrirlo.

Si esto imprime Claude app not found mientras Claude Desktop está claramente instalado, consulta más abajo.

Solución de problemas

Claude app not found en Windows

mcp install busca la configuración de Claude Desktop en una ubicación fija:

%APPDATA%\Claude

Si Claude Desktop se instaló como un paquete MSIX / Microsoft Store, sus datos se redirigen al contenedor del paquete y ese directorio nunca existe:

%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json

Hay dos formas de resolverlo.

Edita la configuración real directamente — añade una entrada mcpServers al claude_desktop_config.json en la ruta del paquete indicada arriba, manteniendo intactas las claves existentes.

O une las rutas una vez con un junction de directorio, tras lo cual mcp install funciona con normalidad para todos los servidores:

cmd /c mklink /J "%APPDATA%\Claude" "%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude"

Sustituye Claude_<id> por el nombre real de la carpeta del paquete. Para deshacerlo, cmd /c rmdir "%APPDATA%\Claude" elimina solo el enlace, no la configuración.

Al registrar el servidor manualmente en Windows, usa la ruta absoluta de uv (p. ej. C:\Users\<you>\.local\bin\uv.exe). Las aplicaciones empaquetadas no heredan de forma fiable el PATH de tu shell, por lo que un uv a secas puede no iniciarse.

Verificar que el servidor está realmente cargado

Confirma que el cliente lo ha lanzado comprobando el proceso padre:

Get-CimInstance Win32_Process -Filter "Name='uv.exe'" | ForEach-Object {
  $p = Get-CimInstance Win32_Process -Filter "ProcessId=$($_.ParentProcessId)"
  "$($_.ProcessId) <- $($p.Name)"
}

Un uv.exe cuyo padre es Claude.exe significa que el servidor se está ejecutando. Ten en cuenta que algunas versiones de Claude Desktop no escriben registros por servidor en logs\, por lo que una carpeta de registros vacía no es evidencia de fallo.

Estructura del proyecto

server/weather.py     the MCP server: tool, resource, and NWS client
main.py               placeholder entrypoint
.mcp.json             Claude Code server config
.cursor/mcp.json      Cursor server config
pyproject.toml        dependencies (httpx, mcp[cli])

Notas

• get_alerts solo cubre estados de EE. UU., ya que NWS es una agencia estadounidense.

• Las solicitudes incluyen una cabecera User-Agent, que la NWS API requiere.

• Los errores de red y HTTP se capturan y aparecen como un mensaje amigable "unable to fetch" en lugar de un traceback.