Real-Time Weather MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Real-Time Weather MCP Server What's the weather in San Francisco?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π€οΈ Real-Time Weather MCP Server
A Model Context Protocol (MCP) server that provides real-time weather information to Claude Desktop and any other MCP-compliant client. Built using FastMCP.
β¨ Features
Live Weather Data: Real-time conditions, temperatures, and forecasts.
Zero API Key Requirement: Uses
wttr.inwithout requiring sign-up or paid subscription keys.FastMCP Powered: High-performance asynchronous tool handling over standard input/output (
stdio).Claude Desktop Ready: One-click registration using the
mcpCLI or manual JSON configuration.
Related MCP server: mcp-weather-server
π Project Structure
real_time_weather-mcp/
βββ main.py # FastMCP server entry point & tool registration
βββ tools/
β βββ __init__.py # Tools package initializer
β βββ weather.py # Weather fetching logic & API handler
βββ pyproject.toml # Modern Python packaging & dependencies
βββ requirements.txt # Standard pip requirements file
βββ .gitignore # Git ignore configuration
βββ LICENSE # MIT License
βββ README.md # Project documentationπ οΈ Prerequisites
Python:
>= 3.10uv (recommended) or standard
pipClaude Desktop (optional, for LLM integration)
π Quick Start
1. Clone the repository
git clone https://github.com/<your-username>/real_time_weather-mcp.git
cd real_time_weather-mcp2. Set up environment & install dependencies
Using uv (recommended):
uv venv
.venv\Scripts\activate # On Windows (or 'source .venv/bin/activate' on macOS/Linux)
uv pip install -e .Using standard pip:
python -m venv .venv
.venv\Scripts\activate # On Windows (or 'source .venv/bin/activate' on macOS/Linux)
pip install -r requirements.txtπ Installing into Claude Desktop
Automatic Installation
Run the FastMCP installer from your activated virtual environment:
mcp install main.pyNote for Windows Store Claude users: If your Claude app was installed from the Microsoft Store, ensure
AppData\Roaming\Claudepoints or links to your local package cache.
Manual Configuration
Add the following to your claude_desktop_config.json:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"Live Weather": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"/absolute/path/to/real_time_weather-mcp/main.py"
]
}
}
}Restart Claude Desktop to activate the tool.
π§ͺ Testing & Debugging
You can test the MCP server using the official MCP Inspector:
npx @modelcontextprotocol/inspector uv run main.pyOr run the server directly in stdio mode:
python main.pyπ οΈ Available MCP Tools
Tool | Parameters | Description |
|
| Fetches real-time weather information for a specified location. If |
π License
This project is licensed under the MIT License.
Available Tools
1 toolcheck_weatherB
Get real-time weather information for a specified location (e.g., "Paris", "New York", "Tokyo").
Args: location: City or location name. detailed: If True, includes feels-like temperature, humidity, wind, and precipitation.
Inputs: location (required), detailed.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 1 tool
There is only one tool, so there is no risk of confusing it with another. Its purpose is clearly stated and distinct.
The single tool follows a clear verb_noun pattern: check_weather. There are no competing conventions to create inconsistency.
A single tool is thin for a server, even one focused on real-time weather. The detailed flag helps, but the surface feels minimal.
For current real-time weather, the tool covers essential output including optional detailed metrics. It lacks features like forecasts, alerts, or multiple locations, but those may be outside the stated real-time scope.
Maintenance
Related MCP Connectors
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Weather MCP β wraps Open-Meteo API (free, no auth)
The official Model Context Protocol server for Ambee. It gives any MCP-compatible AI assistant β Claude, ChatGPT, Cursor, VS Code, Ollama, and more direct access to live air quality, pollen, and weather data. To get started, including information on signing up and obtaining your Ambee key, check out the Ambee documentation on https://docs.ambeedata.com
Unofficial OpenWeather MCP β wraps the OpenWeatherMap API (openweathermap.org)
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides current weather and multi-day forecasts for any location worldwide, integrable with MCP clients like Claude.5Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables MCP clients like Kiro and Claude to access current weather conditions and forecasts for any location using the OpenWeatherMap API.-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to access real-time weather data via MCP, including forecasts and alerts for US locations.79 npmGPL 3.0
- FlicenseNot gradedqualityBmaintenanceEnables users to retrieve weather information through natural language prompts in MCP-compatible clients like Claude for Desktop.-