Overview
What is mcp-server?
Weather MCP server for Cline that provides current weather and 5-day forecasts via the OpenWeatherMap API.
How to use mcp-server?
Set the OPENWEATHERMAP_API_KEY environment variable. Optionally set WEATHER_UNITS (metric/imperial/standard) and LOG_LEVEL. Build with npm run build and start with npm start. The server exposes two tools: get_current_weather and get_weather_forecast.
Key features of mcp-server
- Provides current weather for any city or city,country
- Offers 5‑day weather forecasts (up to 5 days)
- Caches results to reduce API calls (30 min current, 1 hour forecast)
- Supports metric, imperial, and standard unit systems
- Returns formatted weather data including temperature, humidity, wind, and conditions
Use cases of mcp-server
- Integrate real‑time weather data into AI assistants or chat interfaces
- Get short‑term forecasts for travel or event planning
- Automate weather‑aware decision making in applications
FAQ from mcp-server
What environment variables does mcp-server require?
OPENWEATHERMAP_API_KEY is required. WEATHER_UNITS (default metric) and LOG_LEVEL (default info) are optional.
What tools does mcp-server provide?
Two tools: get_current_weather (requires a location string) and get_weather_forecast (requires location, optional days parameter 1‑5, default 3).
How does caching work in mcp-server?
Current weather is cached for 30 minutes; forecasts are cached for 1 hour. Cache is stored in‑memory using node-cache.
What are the runtime dependencies?
Node.js, @modelcontextprotocol/server, axios, node-cache. For development, TypeScript and ts-node are used.
Are there any known limits in mcp-server?
The server does not handle rate limiting or API key validation beyond the OpenWeatherMap API. It uses the MCP protocol; transport and authentication are handled by the MCP host (e.g., Cline).
