What is Mcp Tool

mcp_tool is a minimalist weather query tool that allows users to check global weather conditions using natural language queries. It is designed to work seamlessly with the Cursor editor.

Use cases

Use cases for mcp_tool include integrating weather queries into applications, providing weather information in chatbots, enhancing educational platforms with real-time weather data, and personal use for checking the weather quickly.

How to use

To use mcp_tool, first obtain an OpenWeather API key. Then, you can install it using a one-click command with Smithery or manually clone the repository and install it. After installation, you can query the weather using simple sentences in either Chinese or English.

Key features

Key features of mcp_tool include minimalist one-line weather queries, smart natural language support in both Chinese and English, global coverage for major cities, easy integration with Cursor, high performance with asynchronous processing, and a clear and intuitive weather display.

Where to use

mcp_tool can be used in various fields such as software development, weather forecasting applications, educational tools, and personal projects that require weather information.

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

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

❓ FAQ

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

👨‍💻 Author

• Mr.Car
• Email: [email protected]

🙏 Acknowledgments

• FastMCP
• OpenWeatherMap
• Cursor

📄 License

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