Weather MCP Tool

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

[](https://smithery.ai/server/@MrCare/mcp_tool) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)[English](README.md) | [中文](README_zh.md)

Watch how easy it is to query weather with natural language

✨ Features

• 💡 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

🚀 Quick Start

1. Get API Key

🔑 Before starting, please Get OpenWeather API Key

2. One-Click Installation (Recommended)

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.

3. Manual Installation

3.1 Clone and Install

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

3.2 Configure API Key

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

3.3 Enable Tool

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!

📝 Usage Examples

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!

⚙️ Parameters

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 (zhcn: Chinese, en: English) | zhcn |

❓ FAQ

1. Not Working?

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

1. City Not Found?

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

👨‍💻 Author

• Mr.Car
• Email: 534192336car@gmail.com

🙏 Acknowledgments

• FastMCP
• OpenWeatherMap
• Cursor

📄 License

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