What is MCP Weather Server?
MCP Weather Server is a setup guide for creating and running a weather server using the MCP SDK and the uv
package manager, designed to provide weather forecasts.
How to use MCP Weather Server?
To use the MCP Weather Server, follow the setup guide to install prerequisites, create a project environment, and run the server to fetch weather data.
Key features of MCP Weather Server?
- Easy setup with step-by-step instructions
- Utilizes the MCP SDK for weather data
- Interactive MCP Inspector for testing and debugging
Use cases of MCP Weather Server?
- Fetching current weather data based on geographic coordinates.
- Developing weather-related applications using the MCP SDK.
- Testing and debugging weather data retrieval in a local environment.
FAQ from MCP Weather Server?
- What do I need to set up the MCP Weather Server?
You need a Claude.ai account, the Claude Desktop App, a code editor, and the
uv
package manager installed.
- How do I run the server?
You can start the server in development mode using the command
mcp dev server.py
.
- Can I use this server for any location?
Yes! You can enter any latitude and longitude to get the current weather data.
MCP Weather Server Setup Guide
This guide walks you through setting up and running a weather server using the MCP SDK and uv
, a Rust-based Python package manager.
✅ Prerequisites
Make sure you have the following installed before proceeding:
- Claude.ai account (any account type works — MCP is supported)
- Claude Desktop App (available for macOS and Windows)
- Code Editor (e.g., Visual Studio Code)
uv
— A fast Python package manager written in Rust
uv
:
Install macOS (via Homebrew):
brew install uv
Windows (via WinGet):
winget install --id=astral-sh.uv -e
⚙️ Project Setup
Follow these steps to create and configure the project environment:
-
Create the project folder: mkdir mcp-server-weather cd mcp-server-weather
-
Initialize a new
uv
project: uv init -
Create a virtual environment: uv venv
-
Activate the virtual environment:
macOS / Linux: source .venv/bin/activate
Windows (PowerShell): .venv\Scripts\Activate.ps1
To deactivate the virtual environment: deactivate
- Install required packages: uv add "mcp[cli]" httpx
🚀 Running and Testing the MCP Server
-
Start the MCP server in development mode: mcp dev server.py
-
Open http://localhost:5173 in your browser
-
In the MCP Inspector:
- Click Connect
- Go to the Tools tab
- Click List Tools
- Select get_current_weather
- Enter latitude and longitude (e.g.,
63.4463991, 10.8127596
) - The Tool Result section will display the JSON weather data
-
To stop the server: Ctrl+C
📝 Notes
- Ensure your server script is named
server.py
and located in the root of your project. - The MCP Inspector is a helpful tool for interacting with and debugging tools during development.
