MeteoSwiss MCP Server

(Demo) MCP Server for MeteoSwiss Data

A Model Context Protocol (MCP) server for MeteoSwiss weather data.

Overview

This server provides weather data from MeteoSwiss using the Model Context Protocol (MCP), allowing AI assistants like Claude to access weather information.

Features

• Weather reports for regions in Switzerland (North, South, West)
• Search MeteoSwiss website content across multiple topics
• Fetch full content from MeteoSwiss pages with format conversion
• Multi-language support (German, French, Italian, English)
• Weather forecasts with daily breakdowns
• Intelligent HTTP caching with ETag support
• Test fixtures for development

Architecture

This MCP server runs as an HTTP service with Server-Sent Events (SSE) for real-time communication. It's designed to be accessed remotely using mcp-remote for Claude Desktop integration.

Quick Start

This server runs as an HTTP service and can be accessed using mcp-remote:

# Start the server
npm start  # or: pnpm start

# In Claude Desktop, use:
npx mcp-remote http://localhost:3000/mcp

Development Mode

For development with auto-reload:

# Start with file watching
npm run dev  # or: pnpm dev

# Test with MCP Inspector
npm run dev:inspect

Development

This project uses tsx for TypeScript execution, providing a smooth development experience with hot reloading.

Prerequisites

• Node.js v18.0.0 or later (we recommend using nvm for Node.js version management)
• pnpm for package management

Setting up the development environment

1. Clone the repository:

   git clone https://github.com/eins78/mcp-server-meteoswiss-data.git
   cd mcp-server-meteoswiss-data
   

2. Install dependencies:

   pnpm install
   

3. Use the correct Node.js version:

   nvm use
   

Running the application

Running the Server

The server runs as an HTTP service with Server-Sent Events (SSE):

# Start the server (default port 3000)
pnpm start

# Or specify a custom port
PORT=8080 pnpm start

The HTTP server provides:

• GET / - Server information
• GET /mcp - MCP SSE endpoint for client connections
• POST /messages?sessionId=... - Message handling endpoint
• GET /health - Health check endpoint

Development Mode

Start the development server with hot reloading:

pnpm run dev

Or run the application without hot reloading:

pnpm run start

Type checking

Check TypeScript types without emitting JavaScript files:

pnpm run lint

Project Structure

• src/ - Source code
  • index.ts - Application entry point
  • data/ - Data access and transformation
  • schemas/ - Zod schemas for data validation
  • tools/ - Utility tools and scripts
  • support/ - Supporting infrastructure (logging, validation, etc.)

Documentation

• docs/ - Project documentation
  • architecture/ - Architecture diagrams and descriptions
  • analysis/ - Data analysis and insights

Available Tools

meteoswissWeatherReport

Get official MeteoSwiss weather reports for Swiss regions.

Parameters:

• region: Swiss region (north, south, or west)
  • north: Northern Switzerland (Zurich, Basel, Bern, Swiss Plateau)
  • south: Southern Switzerland (Ticino and southern valleys)
  • west: Western Switzerland/Romandy (Geneva, Lausanne, western Alps)
• language: Report language (de, fr, or it - English not available)
  • Default: de

Returns: Detailed weather report with daily forecasts, temperatures, and regional conditions.

search

Search MeteoSwiss website content with pagination and multi-language support.

fetch

Retrieve full content from MeteoSwiss pages in various formats (markdown, text, HTML).

See the API documentation for detailed tool specifications.

Available Prompts

Pre-configured prompts for common weather queries:

German

• wetterNordschweiz: Current weather report for Northern Switzerland
• wetterSchweiz: Interactive prompt for any Swiss region

French

• meteoSuisseRomande: Current weather report for Western Switzerland (Romandy)

Italian

• meteoTicino: Current weather report for Southern Switzerland (Ticino)

Debugging

For issues with Claude Desktop connections or other debugging needs, see our Debugging Guide.

Running Your Own Instance

Using Node.js

# Clone the repository
git clone https://github.com/eins78/mcp-server-meteoswiss.git
cd mcp-server-meteoswiss

# Install dependencies
pnpm install

# Start the server
pnpm start

# The server will be available at http://localhost:3000

Using Docker

# Run the latest version
docker run -p 3000:3000 -e USE_TEST_FIXTURES=false meteoswiss-mcp-server

# Or build your own
docker build -t my-meteoswis