1. Conduid
  2. Maps
  3. Open Meteo MCP Java
MCP server · Maps

Open Meteo MCP Java

· github.com/schlpbch/open-meteo-mcp-java

A MCP server providing weather, snow conditions, and air quality tools via the Open-Meteo API with conversational AI capabilities.

Unclaimed ai-agentmcpspring
InstallView source
34Low

Scored 6 months ago · breakdown

About Open Meteo MCP Java

Open Meteo MCP Java is an MCP server in the Maps category: a MCP server providing weather, snow conditions, and air quality tools via the Open-Meteo API with conversational AI capabilities.

Install

From source
git clone https://github.com/schlpbch/open-meteo-mcp-java

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

get_air_qualityAQI, pollutants, UV index, pollen

Parameters not published.

get_snow_conditionsSnow depth, snowfall, ski conditions

Parameters not published.

get_weatherWeather forecast with temperature, precipitation

Parameters not published.

search_locationGeocoding - search locations by name

Parameters not published.

Ask AI

✦

Ask AI about Open Meteo MCP Java

Powered by Claude · Grounded in docs

I know everything about Open Meteo MCP Java. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Open Meteo MCP Server (Java)

Version Java Spring Boot Tests Coverage License MCP

One unified server providing weather, snow conditions, and air quality data through three API interfaces (REST, MCP, Chat) - all powered by the same core business logic - via the Open-Meteo API.

Overview

Unified Architecture: Single server application with shared business logic exposing three different API interfaces:

Interface Endpoint Purpose
REST API /api/* Direct HTTP/JSON access to weather services
MCP API /sse Model Context Protocol for AI assistants (Claude)
Chat API /api/chat/* Conversational AI interface with memory

Shared Capabilities:

  • 11 MCP Tools - Weather, snow, air quality, location, alerts, astronomy, marine
  • 4 MCP Resources - Weather codes, parameters, AQI reference, Swiss locations
  • 3 MCP Prompts - Ski-trip, outdoor-activity, travel planning

Quick Start

# Clone and build
git clone https://github.com/schlpbch/open-meteo-mcp-java.git
cd open-meteo-mcp-java
mvn clean install

# Run
mvn spring-boot:run

# Or with Docker
docker compose up --build

Endpoints:

  • Health: http://localhost:8888/actuator/health
  • REST: http://localhost:8888/api/weather (and other /api/* endpoints)
  • MCP: http://localhost:8888/sse
  • Chat: http://localhost:8888/api/chat

Architecture: All three APIs share the same weather services, business logic, and data models. Choose the interface that best fits your use case - REST for direct integration, MCP for AI assistants, or Chat for conversational interactions.

MCP Tools

Core Tools

Tool Description
search_location Geocoding - search locations by name
get_weather Weather forecast with temperature, precipitation
get_snow_conditions Snow depth, snowfall, ski conditions
get_air_quality AQI, pollutants, UV index, pollen

Advanced Tools

Tool Description
get_weather_alerts Weather alerts based on thresholds
get_comfort_index Outdoor activity comfort score (0-100)
get_astronomy Sunrise, sunset, golden hour, moon phase
search_location_swiss Swiss-specific location search
compare_locations Multi-location weather comparison
get_historical_weather Historical data (1940-present)
get_marine_conditions Wave/swell data for lakes and coasts

Claude Desktop Integration

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "open-meteo": {
      "command": "java",
      "args": ["-jar", "/path/to/open-meteo-mcp-2.0.2.jar"]
    }
  }
}

Or use the setup scripts in claude-desktop/.

Configuration

# Environment variables
AZURE_OPENAI_KEY=your_key
OPENAI_API_KEY=your_key
ANTHROPIC_API_KEY=your_key
REDIS_URL=redis://localhost:6379

# application.yml
openmeteo:
  chat:
    enabled: true
    memory:
      type: redis # or inmemory

Testing

mvn test                    # Run all tests
mvn test jacoco:report      # With coverage report

Current: 577 tests passing, 81% instruction coverage (exceeds 80% target)

Documentation

Technology Stack

  • Java 25 with Virtual Threads
  • Spring Boot 4.1.0-M4 / Spring AI 2.0.0-M4 / Spring Security 7.1.0-M3
  • Docker (Eclipse Temurin) / Redis 8
  • JUnit 5 + Mockito + AssertJ + Reactor Test
  • JJWT 0.12.7 (JWT authentication) / Jackson 3 (JSON serialization)

License

Apache 2.0 - See LICENSE

Credits:

v2.1.2 - Enterprise Ready

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Open Meteo MCP Java

How do I install Open Meteo MCP Java?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Open Meteo MCP Java safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Open Meteo MCP Java still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.