Skip to content
MCP server

Weather

Example MCP weather server exposing forecast and alert tools, for learning MCP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.1
Listing updated
today

Similar MCP servers

About Weather

Weather is an open-source MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

The README presents this as a companion example for the official Model Context Protocol tutorial on building a server. It is a deliberately minimal weather server that exposes two tools, a forecast lookup and an alerts lookup, backed by the US National Weather Service API.

The repository holds parallel implementations in Python, TypeScript, Go, Rust and Ruby, all communicating over stdio. Each language also has a matching chatbot client that launches a server and lets an LLM call its tools, and the README notes that clients and servers can be mixed across languages.

It suits developers who want a small, readable reference for wiring tools into an MCP client rather than a production weather service. The README itself warns that the code is intentionally minimal and needs added authentication and hardening before it is exposed over a network.

Install

Run in a terminal

claude mcp add weather --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-ts

Add to claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@dingw1982/mcp-quickstart-ts"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@dingw1982/mcp-quickstart-ts"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "weather": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dingw1982/mcp-quickstart-ts"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@dingw1982/mcp-quickstart-ts"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@dingw1982/mcp-quickstart-ts"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YOUR_API_KEYYour API key for the serviceRequired

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

get_forecast
Returns weather forecast data.
get_alerts
Returns active weather alerts.

What it does

Forecast tool
Returns weather forecast data through a tool named get_forecast (get-forecast in TypeScript).
Alerts tool
Returns active weather alerts through a tool named get_alerts (get-alerts in TypeScript).
Multi-language servers
Equivalent weather servers are provided in Python, TypeScript, Go, Rust and Ruby.
Matching chatbot clients
Companion clients launch a server, list its tools and run an interactive chat loop.
Stdio transport
All servers communicate over standard input and output.

Good for

  • Learning how to build a basic MCP server with tools
  • Comparing MCP server implementations across several programming languages
  • Testing MCP client wiring without API credentials
  • Using as a starting template for a custom tool server

Pricing

Open source

Open-source example code in the MCP quickstart repository.

Weather FAQ

Which transport do the servers use?

All servers communicate over stdio.

Do I need credentials to try the clients?

The README says the example clients need an ANTHROPIC_API_KEY to run the chat loop. Without a key, each client still connects and lists the server's tools before exiting.

Is this production-ready?

No. The README describes the examples as intentionally minimal and says network-exposed servers need authentication and basic hardening.

Is Weather free?

Yes. Weather is open source, so you can use and self-host it for free.

How do I add Weather to Claude Code?

Run this command in your terminal: claude mcp add weather --env YOUR_API_KEY='<YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-ts

What are the best alternatives to Weather?

The closest alternatives to Weather are Weather, Weather, Weather, Weather Alerts & Forecast and Weather.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers