mcp-server

Name: mcp-server
Author: milk19

@milk19

Repository

About mcp-server

No overview available yet

#weather-mcp #weather-api #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-milk19": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/create-server",
        "my-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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