Skip to main content
Glama
vihanrs

Weather MCP Server

by vihanrs
README.md
# Weather MCP Server

An MCP (Model Context Protocol) server that provides weather tools for AI assistants, built with [xmcp](https://xmcp.dev).

## Features

### Tools

- **get-current-weather** - Get current weather conditions for any city (temperature, humidity, wind speed)
- **get-forecast** - Get weather forecast for 1-7 upcoming days
- **compare-weather** - Compare weather between two cities

### Resources

- `weather://{city}/current` - Current weather data as a resource

### Prompts

- **weather-summary** - Generate weather summary prompts

## Installation

```bash
npm install
```

## Usage

### Development

```bash
npm run dev
```

### Production

```bash
npm run build
npm run start
```

### Inspect with MCP Inspector

```bash
npm run inspect
```

## Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-mcp/dist/stdio.js"]
    }
  }
}
```

## API

This server uses the free [Open-Meteo API](https://open-meteo.com/) for weather data. No API key required.

## Tech Stack

- [xmcp](https://xmcp.dev) - MCP framework
- [Zod](https://zod.dev) - Schema validation
- [Open-Meteo API](https://open-meteo.com/) - Weather data

## License

MIT