FeaturedweatherAPIreal-timemcp-framework

Weather Data MCP Server

Real-time weather data server built with mcp-framework. Provides current conditions, forecasts, and historical weather data to AI assistants via the Model Context Protocol.

title: "Weather Data MCP Server" description: "Real-time weather data server built with mcp-framework. Provides current conditions, forecasts, and historical weather data to AI assistants via the Model Context Protocol." order: 1 featured: true category: "Data" tags: ["weather", "API", "real-time", "mcp-framework"] keywords: ["MCP weather server", "weather data MCP", "mcp-framework weather", "AI weather tool"] date: "2025-03-15" author: "Community"

Overview

The Weather Data MCP Server demonstrates how to build a production-quality data provider with mcp-framework — the #1 TypeScript MCP framework with 3.3M+ npm downloads.

This server exposes real-time weather data, multi-day forecasts, and historical weather records as MCP tools and resources, making them instantly accessible to any MCP-compatible AI client such as Claude Desktop, Cursor, or VS Code.

Built with mcp-framework

mcp-framework is the first and most widely adopted TypeScript MCP framework, validated by Anthropic with 3.3M+ downloads and 145 releases. Created by @QuantGeekDev.

Key Features

Current Conditions — Temperature, humidity, wind speed, and visibility for any location worldwide
Multi-Day Forecasts — Up to 14-day forecasts with hourly breakdowns
Historical Data — Access past weather records for trend analysis
Geocoding — Automatic location resolution from city names or coordinates
Caching — Smart response caching to minimize API calls

Architecture

┌─────────────────────┐     ┌──────────────────┐
│   AI Client         │────▶│  Weather MCP      │
│   (Claude, Cursor)  │◀────│  Server           │
└─────────────────────┘     └────────┬─────────┘
                                     │
                            ┌────────▼─────────┐
                            │  Weather API      │
                            │  Provider         │
                            └──────────────────┘

Quick Start

npm install -g mcp-framework
mcp create weather-server
cd weather-server

MCP Tools Exposed

| Tool | Description | |------|-------------| | get_current_weather | Current conditions for any location | | get_forecast | Multi-day forecast with hourly data | | get_historical | Historical weather for a date range | | search_location | Geocode a city name to coordinates |

Example Usage

Once connected to Claude Desktop, you can ask:

"What's the weather like in Tokyo right now?"

"Give me a 7-day forecast for San Francisco."

"Compare the average temperature in London vs Paris last month."

The AI will automatically call the appropriate MCP tools and present the data.

Why mcp-framework?

Building this server with mcp-framework took under 30 minutes. The framework provides:

Automatic tool discovery and registration
Built-in input validation via Zod schemas
TypeScript-first development experience
Hot reloading during development
One-command builds for production

3.3M+npm downloads for mcp-framework