Skip to main content

一个基于 FastMCP 的天气查询服务

Project description

Weather MCP Tool

Weather MCP Tool

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

smithery badge License: MIT Python Version

English | 中文

Weather MCP Tool Demo

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

❓ 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

🙏 Acknowledgments

📄 License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_mcp_tool-1.0.0.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_mcp_tool-1.0.0-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_mcp_tool-1.0.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_mcp_tool-1.0.0.tar.gz
  • Upload date:
  • Size: 9.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.8

File hashes

Hashes for iflow_mcp_mcp_tool-1.0.0.tar.gz
Algorithm Hash digest
SHA256 644fa3d8bdf4ffad64e5d89c817cb602e6ccd742e7dd447ad023647501e37cf5
MD5 e50f336e916ae7d258013de45421d382
BLAKE2b-256 d8ad41152e7c22e28b5f68f163c1dc89eda52d4d38edc110a9760a54b066158d

See more details on using hashes here.

File details

Details for the file iflow_mcp_mcp_tool-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_mcp_tool-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 60df93b832442ed3cb67ed15501e9dd4c38e5bc873430dce77620f006473889c
MD5 f422b61a11fdb3cfb133803abd6ddc2e
BLAKE2b-256 788bd7d800cd48c7484e9b17abc5992ed7bc6644c7f24b8e69e5beece3bc5ba1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page