Aareguru MCP Server
MCP server for Swiss Aare river data, enabling AI assistants like Claude to answer questions about swimming conditions, water temperature, flow rates, and safety.
🚀 Quick Start
Use directly from FastMCP Cloud (no installation needed):
Add it is as custom connector in Claude Desktop:
No authentication is needed.
Altnernatively, you can add the aareguru-mcp.mcpb file via option in Claude -> Settings -> Extensions. Or edit the Claude desktop config file directly:
📸 Screenshots
🎯 Features
Feature | Description |
7 MCP Tools | Temperature, flow, safety, forecasts, comparisons, history |
4 MCP Resources | Direct data access via |
3 MCP Prompts | Daily reports, spot comparisons, weekly trends |
Rate Limiting | 100 req/min, 1000 req/hour protection against abuse |
Metrics | Prometheus endpoint for monitoring and observability |
Swiss German | Authentic temperature descriptions ("geil aber chli chalt") |
BAFU Safety | Official flow danger levels and thresholds |
Smart UX | Proactive safety warnings, alternative suggestions, seasonal context |
200+ Tests | 83% coverage, comprehensive test suite |
🛠️ Tools
Tool | Description | Example Query |
| Water temperature with Swiss German text | "What's the Aare temperature?" |
| Full conditions (temp, flow, weather) | "How's the Aare looking today?" |
| Flow rate + BAFU safety assessment | "Is it safe to swim?" |
| All monitored cities | "Which cities have data?" |
| Temperature/flow history | "Show last 7 days" |
| Multi-city comparison | "Which city is warmest?" |
| Temperature/flow forecast | "Will it be warmer later?" |
BAFU Safety Thresholds
Flow Rate | Level | Status |
< 100 m³/s | Safe | Swimming OK |
100-220 m³/s | Moderate | Experienced swimmers only |
220-300 m³/s | Elevated | Caution advised |
300-430 m³/s | High | Dangerous |
> 430 m³/s | Very High | Extremely dangerous |
📊 Resources
URI | Description |
| List of all monitored cities |
| Full current data for a city |
| Minimal current data |
| Overview of all cities |
💬 Prompts
Prompt | Description |
| Comprehensive daily report with conditions, safety, forecast, and recommendation |
| Compare all cities to find the best swimming spot today |
| Analyze temperature and flow trends over the past week |
💻 Local Installation
Claude Desktop (Local)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
🐳 Docker
☁️ Hosting
FastMCP Cloud (Recommended)
This server is deployed on FastMCP Cloud, a managed platform for MCP servers with zero-config deployment.
Features:
✅ Zero-Config Deployment - Connect GitHub repo, automatic deployment
✅ Serverless Scaling - Scale from 0 to millions of requests instantly
✅ Git-Native CI/CD - Auto-deploy on push to
main, branch deployments for PRs✅ Built-in Security - OAuth support, token management, secure endpoints
✅ MCP Analytics - Request/response tracking, tool usage insights
✅ Free Tier - Available for personal servers
Deployment Steps:
Sign in to fastmcp.cloud with GitHub
Create Project and link your repository
Deploy - Platform automatically clones, builds, and deploys
Access - Get your unique URL (e.g.,
https://aareguru.fastmcp.app/mcp)
Configuration:
No special configuration needed! FastMCP Cloud auto-detects FastMCP servers. The server runs with:
Health endpoint:
https://your-app.fastmcp.app/healthMCP endpoint:
https://your-app.fastmcp.app/mcp
Pricing:
Free tier for personal projects
Pay-as-you-go for teams (usage-based)
Alternative Hosting Options
FastMCP servers can be deployed to any Python-compatible cloud platform:
Container Platforms:
Google Cloud Run
AWS ECS/Fargate
Azure Container Instances
PaaS Providers:
Railway
Render
Vercel
Cloud VMs:
AWS EC2
Google Compute Engine
Azure VMs
Deployment Pattern:
Then containerize with Docker and deploy to your chosen platform.
📊 Monitoring & Observability
Prometheus Metrics
The server exposes Prometheus-compatible metrics at /metrics for monitoring:
Available Metrics:
aareguru_mcp_tool_calls_total- Counter of tool invocations by name and statusaareguru_mcp_tool_duration_seconds- Histogram of tool execution timesaareguru_mcp_api_requests_total- Counter of Aareguru API requestsaareguru_mcp_errors_total- Counter of errors by type and componentaareguru_mcp_active_requests- Gauge of currently active requests
Example:
Rate Limiting
HTTP endpoints are protected with rate limiting:
Default limits: 100 requests/minute, 1000 requests/hour
Health endpoint: 60 requests/minute
Headers: Rate limit info included in responses
429 responses: Automatic retry-after headers when limits exceeded
🧪 Development
📁 Project Structure
🔒 Data Attribution
Data from BAFU, Aare.guru, MeteoSchweiz, Meteotest.
Non-commercial use only - Contact: aaregurus@existenz.ch
📄 License
MIT License - See LICENSE
Built with ❤️ for the Swiss Aare swimming community
