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., "@Weather MCP Server what's the weather like in Paris right now?"
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.
Weather MCP Server
A Model Context Protocol (MCP) server that provides real-time weather information for any location worldwide using the wttr.in service.
Overview
This MCP server exposes a fetch_weather tool that allows AI assistants like Claude to retrieve current weather information for any city or location. It's built using FastMCP and provides a simple, reliable interface for weather data.
Related MCP server: Weather MCP Server
Features
🌤️ Real-time weather information for any location
🌍 Worldwide coverage
⚡ Fast and lightweight
🔌 Easy integration with MCP-compatible clients (Claude Desktop, etc.)
📦 Simple setup with minimal dependencies
Prerequisites
Python 3.12 or higher
uvpackage manager (recommended) orpip
Installation
Clone this repository:
git clone <your-repo-url>
cd weather-mcpInstall dependencies using
uv:
uv pip install -e .Or using pip:
pip install -e .Configuration
Claude Desktop
To use this server with Claude Desktop, add the following configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"weather-bot": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/weather-mcp",
"run",
"main.py"
]
}
}
}Replace /absolute/path/to/weather-mcp with the actual path to this project directory.
Usage
Once configured, the weather tool will be available to your AI assistant. You can ask questions like:
"What's the weather in London?"
"Tell me the current weather in New York"
"How's the weather in Tokyo?"
Running Standalone
You can also run the server directly for testing:
python main.pyOr test the weather function directly:
python tools/weather.pyAvailable Tools
fetch_weather
Retrieves current weather information for a specified location.
Parameters:
location(string): The city or location name (e.g., "London", "New York", "Tokyo")
Returns:
A string containing the weather information including temperature and conditions
Example Response:
London: ⛅️ +12°CProject Structure
weather-mcp/
├── main.py # MCP server entry point
├── tools/
│ ├── __init__.py
│ └── weather.py # Weather fetching logic
├── pyproject.toml # Project configuration
├── README.md # This file
└── uv.lock # Dependency lock fileTechnical Details
MCP Framework: FastMCP
Weather API: wttr.in - a console-oriented weather service
Transport: stdio (standard input/output)
Python Version: 3.12+
How It Works
The server exposes a
fetch_weathertool via the Model Context ProtocolWhen called, it makes an HTTP request to wttr.in's API
The weather data is formatted and returned to the MCP client
The AI assistant can then present this information naturally to the user
Troubleshooting
Server not appearing in Claude Desktop
Verify the path in your config file is absolute and correct
Restart Claude Desktop completely
Check the Claude Desktop logs for any error messages
Weather data not loading
Ensure you have an active internet connection
The wttr.in service must be accessible from your network
Some corporate networks may block access to external weather services
Acknowledgments
Made with ❤️ for the MCP community
Available Tools
1 toolfetch_weatherC
Get weather information for a given location
Inputs: location (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly distinct as it is the only one available.
The single tool name follows a clear verb_noun pattern (fetch_weather), and with only one tool, consistency is inherently perfect as there are no other names to compare against.
A single tool is too few for a weather server's apparent scope, which typically involves multiple operations like forecasts, alerts, or historical data. This minimal set feels thin and limits functionality.
The tool surface is severely incomplete for a weather domain. It only provides current weather information, with obvious gaps such as missing forecasts, alerts, or location-based queries, which are essential for typical weather-related workflows.
Maintenance
Related MCP Connectors
Current weather and forecast lookup as an agent tool.
Global weather via Open-Meteo: forecast, historical, marine, air quality, geocoding, elevation.
Get current weather for any city and create images from your prompts. Streamline planning, reports…
Provide real-time and forecast weather information for locations in the United States using natura…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides real-time weather information and forecasts, connecting AI assistants with live weather data for current conditions and multi-day forecasts for any location worldwide.-
- AlicenseNot gradedqualityNot gradedmaintenanceProvides real-time weather information for global locations and 12 major Chinese cities using the wttr.in API. It enables users to query temperature, humidity, and atmospheric conditions through the HelloAgents framework.MIT
- FlicenseNot gradedqualityDmaintenanceEnables querying weather data through natural language, providing current conditions, daily and hourly forecasts, and city comparisons using the wttr.in API.-
- AlicenseNot gradedqualityDmaintenanceEnables real-time weather queries for Chinese and global cities via the wttr.in API, providing current conditions such as temperature, humidity, and wind speed.MIT