mcp -openmeteo

The OpenMeteo MCP Server exposes weather data by wrapping the free OpenMeteo API into MCP-compatible tools. It provides four primary capabilities: get_current_weather to fetch real-time conditions for a given latitude and longitude; get_weather_forecast to retrieve up to 16 days of daily forecasts for a location; get_historical_weather to obtain historical data over a date range for analysis; and search_locations to find coordinates and details for cities or places worldwide. Each tool returns structured meteorological information such as temperature, humidity, wind, precipitation, cloud cover, and descriptions, with human-friendly formatting and optional emojis. To integrate with clients (e.g., Claude Desktop or other MCP-enabled agents), add this server to your MCP configuration and invoke the tools by specifying the required parameters (latitude and longitude for current and forecast queries; plus dates for historical data; and a text query for location search).

Typical usage flows include: installing the binary, starting the server, and then issuing MCP tool calls from your client. For example, you can query current weather for New York City by providing its latitude and longitude, or search for a city to obtain its coordinates and then use those coordinates with the weather tools. The server communicates with the OpenMeteo API behind the scenes and formats results into easy-to-read responses suitable for chat-based assistants.

Installation steps:

Prerequisites:

• Rust toolchain (Rust 1.87 or newer) and Cargo installed
• Git (for cloning the repository, if building from source)

Option 1: Download Pre-built Binary (Recommended)

1. Visit the Releases page and download the latest binary: https://github.com/gbrigandi/mcp-server-openmeteo/releases
2. Make the binary executable (if needed): chmod +x mcp-server-openmeteo
3. Run the binary directly to start the server: ./mcp-server-openmeteo

Option 2: Build from Source Prerequisites:

• Rust 1.87+ and Cargo
• Git

Build steps:

git clone https://github.com/gbrigandi/mcp-server-openmeteo
cd mcp-server-openmeteo
cargo build --release

The compiled binary will be at: target/release/mcp-server-openmeteo.

Starting the server after building:

./target/release/mcp-server-openmeteo

If you prefer to run in a managed environment, you can package the binary in a container or use your system’s service manager to keep it running in the background.

Tips and notes:

• The server uses the free OpenMeteo API, which does not require an API key. Ensure you have network access to OpenMeteo endpoints.
• You can control logging verbosity with the RUST_LOG environment variable, for example: RUST_LOG=debug ./target/release/mcp-server-openmeteo
• When integrating with Claude Desktop or other MCP clients, ensure the MCP configuration points to the correct executable path and that the client has permission to execute the binary.
• If you plan to expose the server publicly, consider adding access controls or IP allowlists and configuring a sensible timeout (the server uses a 30-second timeout for API requests by default).
• For location searches, supply queries in formats like "Paris, France" or just "Tokyo" to receive coordinates suitable for weather queries.
• If you encounter build issues, ensure you’re using a Rust toolchain compatible with the repository (as noted in the README), and verify network access to OpenMeteo if running in a restricted environment.