Weather Edge MCP

Sinais calibrados de probabilidade climática para os mercados de previsão Kalshi. Modelo duplo: previsão do NWS + ensemble de 31 membros do GFS. METAR em tempo real das estações de liquidação.

Documentação

Weather Edge MCP Server

weather-edge-mcp MCP server

Weather Edge é um servidor MCP para sinais calibrados do mercado meteorológico da Kalshi. Ele transforma dados públicos de previsão e mercado em uma superfície compacta de ferramentas para agentes de IA.

O que ele faz

  • calibra previsões diárias de temperatura máxima do NWS por cidade
  • lê os preços atuais do mercado meteorológico da Kalshi
  • estima probabilidade por faixa, vantagem (edge) e valor esperado líquido
  • expõe os resultados por meio de ferramentas MCP e uma superfície opcional FastAPI

Instalação

pip install weather-edge-mcp

Uso do MCP

Claude Desktop

{
  "mcpServers": {
    "weather-edge": {
      "command": "python",
      "args": ["-m", "weather_edge_mcp"]
    }
  }
}

Outros clientes MCP

Use qualquer um destes comandos:

weather-edge-mcp
python -m weather_edge_mcp

Opções de transporte

weather-edge-mcp --transport stdio
weather-edge-mcp --transport sse --port 8050
weather-edge-mcp --transport streamable-http --port 8050

Ferramentas

FerramentaDescrição
get_weather_signals(city)Sinais calibrados para os mercados meteorológicos da Kalshi de uma cidade
get_all_signals()Varredura completa em todas as cidades suportadas
get_forecast(city)Contexto de previsão ajustado por viés para uma cidade suportada
get_station_observation(city)Última observação METAR da estação de liquidação
list_cities()Cidades suportadas e parâmetros de calibração

Cidades suportadas: nyc, chicago, denver, miami, la

API web opcional

Weather Edge também inclui um aplicativo FastAPI opcional:

python -m uvicorn weather_edge_mcp.web_app:app --host 0.0.0.0 --port 8080

Rotas:

  • /api/health
  • /api/signals?city=nyc
  • /api/all-signals
  • /dashboard
  • /subscribe

Se a stack opcional x402 estiver instalada e configurada, as rotas pagas podem ser controladas por ela. O modo stdio do MCP permanece limpo e sem efeitos colaterais.

Docker

O repositório inclui um Dockerfile para builds Glama/container.

docker build -t weather-edge-mcp .
docker run --rm weather-edge-mcp --help

Arquitetura

src/weather_edge_mcp/
  core.py        # forecasting, market fetches, calibration, formatting
  mcp_server.py  # MCP tools
  web_app.py     # optional FastAPI surface
  cli.py         # command-line entrypoint

Fontes de dados

  • API de previsão do National Weather Service
  • API METAR de Meteorologia da Aviação
  • API pública de mercado da Kalshi

Desenvolvimento

python -m unittest discover -s tests -v
python -m build

Licença

MIT