Skip to main content
Glama
MCP Weather Server

MCP Weather Server

by microsoft

MCP Weather Server

A simple Model Context Protocol (MCP) server that provides real-time weather data to AI agents like GitHub Copilot.

Quick Start

Clone the repository:

git clone https://github.com/microsoft/lets-learn-mcp-javascript.git
cd mcp-weather-server

1. Install Dependencies

npm install

2. Run the Server

Test with MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

3. Use with VS Code

  1. Open the mcp.jsonfile in .vscode folder

  2. Click the start server button above line 4

  3. Open Chat mode and select agent and choose a modal that supports MCPs such as Claude Sonnet

  4. Type or speak into the chat and ask it what the weather is like in your city

Related MCP server: MCP Weather Server

Features

  • 🌤️ Real-time weather data for any city

  • 🌍 No API key required (uses Open-Meteo)

  • 🤖 Works with GitHub Copilot and other MCP-compatible AI tools

  • ⚡ Easy to test with MCP Inspector

Usage Examples

Ask GitHub Copilot:

  • "What's the weather like in Tokyo?"

  • "How's the weather in London today?"

  • "Give me the current weather for Paris"

How It Works

The server provides a get-weather tool that:

  1. Converts city names to coordinates using geocoding

  2. Fetches current weather data from Open-Meteo API

  3. Returns structured data that AI agents can format beautifully

Code Structure

// Creates MCP server with weather tool
const server = new McpServer({
  name: "Weather Server",
  version: "1.0.0"
});

// Defines the get-weather tool
server.tool('get-weather', 'Tool to get the weather of a city', ...);

// Connects via stdio transport
const transport = new StdioServerTransport();
server.connect(transport);

Dependencies

  • @modelcontextprotocol/sdk - MCP server framework

  • zod - Schema validation

  • tsx - TypeScript execution (for development)

API Used

  • Open-Meteo - Free weather API with no authentication required

Available Tools

2 tools
get_alertsB

Get weather alerts for a state

Inputs: state (required).

get_forecastB

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: get_alerts retrieves weather alerts for a state, while get_forecast provides weather forecasts for a location. There is no overlap in functionality, making it easy for an agent to select the correct tool based on the need for alerts versus forecasts.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern with 'get_' prefix and descriptive nouns (alerts, forecast). This uniformity enhances readability and predictability, making the tool set easy to navigate and understand.

    Tool Count2/5

    With only 2 tools, the server feels under-scoped for a weather domain, which typically involves more operations like current conditions, historical data, or radar information. This limited set may restrict agent capabilities in handling comprehensive weather-related tasks.

    Completeness2/5

    The tool surface is significantly incomplete for a weather server, lacking essential operations such as getting current conditions, historical weather data, or radar imagery. This creates notable gaps that could lead to agent failures when trying to perform common weather-related workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
      1
      -
    • A
      license
      B
      quality
      D
      maintenance
      A simple server that implements the Model Context Protocol, allowing AI models like Claude to fetch real-time weather information for any location using the wttr.in API.
      4
      1
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables AI assistants and LLMs to access real-time weather data and forecasts by connecting to the OpenWeatherMap API.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables natural language weather queries for global cities, integrating with OpenWeather API to provide real-time weather information in an easy-to-read format.
      1
      -