# Weather MCP Server

[![CI](https://github.com/Yaseen-md/weather-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/Yaseen-md/weather-mcp-server/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A standard [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides real-time weather forecasts based on city names using the Open-Meteo API.

## Features

- **Geocoding**: Automatically converts city names to geographic coordinates (latitude & longitude)
- **Real-time Weather**: Retrieves current temperature, wind speed, and weather codes
- **MCP Integration**: Fully compatible with MCP clients like Claude Desktop
- **Zero API Keys**: Uses the free, open-source Open-Meteo API—no registration required!

## Prerequisites

- Node.js >= 18.x
- npm or yarn

## Installation

1. Clone the repository:
```bash
git clone https://github.com/Yaseen-md/weather-mcp-server.git
cd weather-mcp-server
```

2. Install dependencies:
```bash
npm install
```

3. Build the server:
```bash
npm run build
```

## Development

Run the server directly without building:
```bash
npm run dev
```

## Integrating with Claude Desktop

To use this weather server with Claude Desktop, you need to configure your `claude_desktop_config.json` file.

**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add the following configuration:

```json
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "C:/path/to/your/weather-mcp-server/build/index.js"
      ]
    }
  }
}
```
*(Make sure to replace the path with the actual absolute path to your built `index.js` file.)*

## Tools Available

### `get_weather`
Fetches the current weather for a specified city.

**Input parameters:**
- `city` (string): The name of the city (e.g., "Delhi", "Tokyo", "London", "San Francisco")

**Returns:**
Temperature in Celsius, wind speed, and weather code.

## License

This project is licensed under the [MIT License](LICENSE).