mcp-server

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).