Skip to main content
Glama
temperature-open-meteo

temperature-open-meteo

Temperature

Este projeto e um laboratorio pratico para estudar prompts, inteligencia artificial e integracoes com MCP (Model Context Protocol). A aplicacao de clima serve como exemplo concreto: um servidor MCP consulta as condicoes atuais na Open-Meteo, enquanto uma aplicacao web consome essa ferramenta por meio de um backend.

Repositorio organizado como workspace npm. O servidor MCP de clima fica em mcps/temperature/; a aplicacao web consome sua ferramenta sem duplicar a integracao meteorologica. Os prompts relacionados ao desenvolvimento ficam em prompts/.

Estrutura

mcps/
  temperature/
    src/                 Servidor MCP e integracao Open-Meteo
    test/                Testes do MCP
    scripts/             Verificacao da API real
    package.json         Dependencias e comandos do MCP
    README.md            Documentacao do servidor
src/
  backend/               API HTTP, Geocoding, cliente MCP e recomendacoes
  frontend/              React, TypeScript, Vite e cenarios climaticos
  shared/                Tipos compartilhados pela aplicacao
.vscode/                 Configuracao MCP e depuracao
prompts/                 Prompts existentes
package.json             Workspace e comandos da raiz
package-lock.json        Lockfile compartilhado

Related MCP server: OpenWeather MCP Server

Instalacao e comandos

Requer Node.js 22 ou superior. Execute na raiz do repositorio:

npm ci
npm run build
npm run typecheck
npm test

Os comandos da raiz compilam e testam o MCP e a aplicacao web:

npm run dev        # Backend :3001 e frontend :5173
npm run build      # MCP, backend e frontend de producao
npm start          # Aplicacao compilada em :3001
npm test           # Testes locais, sem consulta meteorologica live
npm run test:live  # Consulta real pelo MCP; requer build e acesso a rede

Abra http://localhost:5173 durante o desenvolvimento e http://localhost:3001 depois do build. PORT altera a porta do backend.

O backend pesquisa cidades pela API oficial de Geocoding da Open-Meteo e inicia o MCP existente como subprocesso Node.js usando o transporte stdio e o cliente oficial MCP v2. O navegador conversa somente com a API HTTP. O MCP entrega temperatura, sensacao, chuva, umidade, periodo do dia e codigo WMO; a interface usa o fuso horario retornado pelo Geocoding para mostrar a hora local. Em caso de falha, nenhum dado meteorologico substituto e exibido. As cinco cidades mais recentes ficam guardadas localmente no navegador.

Tambem e possivel selecionar o pacote explicitamente:

npm run build --workspace temperature-mcp

O VS Code continua usando .vscode/mcp.json na raiz. Depois do build, inicie temperature-open-meteo em MCP: List Servers. Se ja estava em execucao antes da reorganizacao, reinicie-o para aplicar o novo caminho.

Consulte a documentacao do MCP para detalhes da ferramenta get_current_weather, tratamento de erros e configuracao de clientes.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables real-time weather information and forecasts using the Open-Meteo API. Provides current weather conditions and forecast data for any location specified by latitude and longitude coordinates.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time weather data and forecasts for locations worldwide using the OpenWeatherMap API. It enables AI assistants to retrieve current conditions, temperature, and forecasts through a simple tool-based interface.
      MIT
    • F
      license
      D
      quality
      D
      maintenance
      Provides real-time weather information, enabling AI assistants to retrieve current temperature and weather conditions for any location worldwide.
      1
      -