# Weather

> Weather is an open-source MCP server for maps and travel. Example MCP weather server exposing forecast and alert tools, for learning MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/dingw1982/quickstart-resources
- **MCP Registry name:** io.github.dingw1982/weather
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_forecast`: Returns weather forecast data.
- `get_alerts`: Returns active weather alerts.

## 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.

## Alternatives

- [Weather](https://ai-powered.com/mcp/weather-10): Weather is an open-source MCP server for maps and travel.
- [Weather](https://ai-powered.com/mcp/weather-5): Weather is an open-source MCP server for maps and travel.
- [Weather](https://ai-powered.com/mcp/weather-9): Weather is an open-source MCP server for maps and travel.
- [Weather Alerts & Forecast](https://ai-powered.com/mcp/weather-alerts-and-forecast): Weather Alerts & Forecast is an open-source MCP server for maps and travel.
- [Weather](https://ai-powered.com/mcp/weather-17): Weather is a freemium MCP server for maps and travel.
- [Weather MCP Server by Meteosource](https://ai-powered.com/mcp/weather-mcp-server-by-meteosource): Weather MCP Server by Meteosource is a freemium MCP server for maps and travel.
- [Tollbooth Sample](https://ai-powered.com/mcp/tollbooth-sample): Tollbooth Sample is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/weather-7
