mcp-server

@milk19

About mcp-server

No overview available yet

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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

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