Weather MCP Server

A standard Model Context Protocol (MCP) 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:

git clone https://github.com/Yaseen-md/weather-mcp-server.git
cd weather-mcp-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

Development

Run the server directly without building:

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:

{
  "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.