Skip to main content
Glama
US Weather MCP Server

US Weather MCP Server

by felipecararo

MCP de Clima do Tempo para os EUA 🌤️

Servidor MCP (Model Context Protocol) que fornece informações sobre o clima dos Estados Unidos.

📋 Pré-requisitos

  • Node.js (versĂŁo 14 ou superior)

  • npm (gerenciador de pacotes do Node.js)

Related MCP server: Weather MCP Server

🚀 Instalação

  1. Clone o repositĂłrio:

git clone https://github.com/FelipeCararo/mcp-intro.git
cd mcp-intro
  1. Instale as dependĂŞncias:

npm install

đź”§ Como Usar

Compilar o projeto

Para compilar o cĂłdigo TypeScript:

npm run build

Executar o servidor

ApĂłs compilar, execute o servidor MCP:

npm start

Ou execute diretamente o comando weather:

./build/index.js

Script de inicialização

Você também pode usar o script shell incluído:

./start-mcp.sh

📦 Estrutura do Projeto

mcp-intro/
├── src/           # Código fonte TypeScript
├── build/         # Código compilado (gerado após build)
├── package.json   # Configurações e dependências
├── tsconfig.json  # Configurações do TypeScript
└── README.md      # Este arquivo

🛠️ Tecnologias Utilizadas

  • TypeScript - Linguagem de programação

  • @modelcontextprotocol/sdk - SDK do Model Context Protocol

  • Zod - Validação de schemas e tipos

📝 Scripts Disponíveis

  • npm run build - Compila o cĂłdigo TypeScript

  • npm start - Executa o servidor compilado

  • npm test - Executa os testes (ainda nĂŁo implementado)

🤝 Contribuindo

Sinta-se Ă  vontade para abrir issues e pull requests no repositĂłrio.

📄 Licença

ISC

Available Tools

2 tools
get_alertsC

Get weather alerts for a state

Inputs: state (required).

get_forecastC

Get weather forecast for a location

Inputs: latitude (required), longitude (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one retrieves weather alerts for a state, while the other provides forecasts for a location. There is no overlap or ambiguity between these functions, making it easy for an agent to select the correct tool based on the user's request.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern with 'get_' as the prefix, ensuring predictability and readability. The naming style is uniform across the toolset, with no deviations or mixed conventions.

    Tool Count2/5

    With only two tools, the server feels thin for a weather domain, as it lacks essential operations like current conditions, historical data, or radar information. This minimal set may limit an agent's ability to handle comprehensive weather-related queries effectively.

    Completeness2/5

    The tool surface is significantly incomplete for a weather server, missing core functionalities such as current weather, radar maps, or severe weather details. While alerts and forecasts are useful, the absence of these key operations creates notable gaps that could lead to agent failures in broader scenarios.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.
      2
      90 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI models to fetch weather alerts and detailed forecasts for US locations using the National Weather Service API.
      90 npm
      GPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.
      -