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