Open-Meteo-MCP-Server

nprousalidis/Open-Meteo-MCP-Server

3.2

If you are the rightful owner of Open-Meteo-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Open-Meteo MCP Server provides a secure interface for AI assistants to access weather forecasts and current conditions globally using the Open-Meteo API.

Tools
2
Resources
0
Prompts
0

Open-Meteo MCP Server

A Model Context Protocol (MCP) server that provides weather forecasts from the Open-Meteo API.

Purpose

This MCP server provides a secure interface for AI assistants to retrieve weather forecasts and current weather conditions for any location worldwide using the free Open-Meteo API.

Features

Current Implementation

  • get_7day_forecast - Get a comprehensive 7-day weather forecast including temperature highs/lows, precipitation, weather conditions, and wind speed
  • get_current_weather - Get current weather conditions including temperature, humidity, wind, and precipitation

Prerequisites

  • Docker Desktop with MCP Toolkit enabled
  • Docker MCP CLI plugin (docker mcp command)
  • No API key required - Open-Meteo is free for non-commercial use

Installation

See the step-by-step instructions provided with the files.

Usage Examples

In Claude Desktop, you can ask:

  • "What's the weather forecast for New York City for the next week?" (latitude=40.7128, longitude=-74.0060)
  • "Show me the 7-day forecast for London" (latitude=51.5074, longitude=-0.1278)
  • "What's the current weather in Tokyo?" (latitude=35.6762, longitude=139.6503)
  • "Get me the weather forecast for San Francisco" (latitude=37.7749, longitude=-122.4194)
  • "What's the weather like in Paris right now?" (latitude=48.8566, longitude=2.3522)

Note: You need to provide latitude and longitude coordinates. Claude can help you find these for any city.

Architecture

Claude Desktop → MCP Gateway → Open-Meteo MCP Server → Open-Meteo API
                                                       (api.open-meteo.com)

Development

Local Testing

# Run directly
python openmeteo_server.py

# Test MCP protocol
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python openmeteo_server.py

Adding New Tools

  1. Add the function to openmeteo_server.py
  2. Decorate with @mcp.tool()
  3. Update the catalog entry with the new tool name
  4. Rebuild the Docker image

Troubleshooting

Tools Not Appearing

  • Verify Docker image built successfully: docker images | grep openmeteo
  • Check catalog and registry files
  • Ensure Claude Desktop config includes custom catalog
  • Restart Claude Desktop completely

API Errors

  • Verify coordinates are valid (latitude: -90 to 90, longitude: -180 to 180)
  • Check internet connectivity
  • Open-Meteo may have rate limits for excessive use

Temperature Units

  • Supported units: celsius (default) or fahrenheit
  • Example: get_7day_forecast(latitude="40.7128", longitude="-74.0060", temperature_unit="fahrenheit")

API Details

This server uses the Open-Meteo Weather Forecast API:

Security Considerations

  • No authentication required for Open-Meteo API
  • Running as non-root user in Docker container
  • All requests are read-only
  • No sensitive data stored or logged

Attribution

Weather data provided by Open-Meteo.com

  • API: https://open-meteo.com
  • License: Attribution 4.0 International (CC BY 4.0)
  • Data sources: National weather services worldwide

License

MIT License