README - Weather MCP Tool by mrcare

Weather MCP Tool

A minimalist weather query tool that lets you check global weather with just one sentence, perfectly integrated with Cursor editor.

Watch how easy it is to query weather with natural language

🔑 Before starting, please Get OpenWeather API Key

Install and configure with Smithery in one command:

npx -y @smithery/cli@latest install @MrCare/mcp_tool --client cursor --config "{\"openweathermapApiKey\":\"your_api_key_here\",\"port\":8000}"

For WindSurf and Cine installation, please visit our Smithery repository.

git clone https://github.com/yourusername/weather-server.git && cd weather-server && pip install -e .

Method 1: Using Configuration File (Recommended)

Copy the example configuration file and modify it:

cp env.example .env

Then edit the .env file, replace your_api_key_here with your API Key.

Method 2: Using Environment Variables

macOS/Linux:

export OPENWEATHERMAP_API_KEY="your_api_key"

Windows:

set OPENWEATHERMAP_API_KEY=your_api_key

Edit ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json):

{
    "weather_fastmcp": {
        "command": "python",
        "args": ["-m", "weather_server.server"]
    }
}

Restart Cursor and you're ready to go!

Simply type in Cursor:

Show me the weather in Tokyo
What's the forecast for London?
How's the weather in New York?
Will it rain tomorrow in Paris?

That's it!

For more precise queries, you can specify these parameters:

Parameter	Description	Default
city	City name (Chinese/English)	Required
days	Forecast days (1-5)	5
units	Temperature unit (metric: Celsius, imperial: Fahrenheit)	metric
lang	Response language (zh_cn: Chinese, en: English)	zh_cn

Not Working?
- Ensure API Key is set correctly
- Restart Cursor
- Check Python environment
City Not Found?
- Try using English name
- Check spelling
- Use complete city name