Weather MCP Tool

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

English | 中文

Watch how easy it is to query weather with natural language

• 💡 Minimalist: One-line weather query
• 🤖 Smart: Natural language support in Chinese/English
• 🌏 Global: Support for all major cities
• 🔌 Plug & Play: Perfect Cursor integration
• 🚀 High Performance: Async processing, quick response
• 🎨 Beautiful: Clear and intuitive weather display

🔑 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:

1. Not Working?

   • Ensure API Key is set correctly
   • Restart Cursor
   • Check Python environment

2. City Not Found?

   • Try using English name
   • Check spelling
   • Use complete city name

• Mr.Car
• Email: [email protected]

• FastMCP
• OpenWeatherMap
• Cursor

This project is licensed under the MIT License - see the LICENSE file for details