A weather MCP MCP Server powered by OpenWeatherMap
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"weather-mcp-server-beijing-pycoder-2026","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Weather MCP Server 🌦️ A simple, ready-to-use **MCP (Model Context Protocol) Server** that provides real-time weather information via the OpenWeatherMap API. Perfect for AI agents, Claude Desktop, TRAE IDE, and any MCP-compatible client. --- ## ✨ Features - 🌍 Query current weather by city name - 🧠 Designed for LLM tool calling (MCP) - ⚡ Fast startup with `uvx` - 🔐 Secure API key handling via environment variables --- ## 📦 Installation ### Option 1: Run directly (recommended) ```bash uvx weather-mcp-server ``` ### Option 2: Install from PyPI ```bash pip install weather-mcp-server weather-mcp-server ``` --- ## 🔑 Setup 1. Get a free API key from [OpenWeatherMap](https://openweathermap.org/api). 2. Set the environment variable: ```bash export OPENWEATHER_API_KEY="your_api_key_here" ``` > On Windows (PowerShell): > ```powershell > $env:OPENWEATHER_API_KEY="your_api_key_here" > ``` --- ## 🛠️ Usage with MCP Clients ### Example: TRAE IDE / Claude Desktop Add this to your MCP configuration: ```json { "mcpServers": { "weather": { "command": "uvx", "args": ["weather-mcp-server"], "env": { "OPENWEATHER_API_KEY": "your_api_key_here" } } } } ``` Then ask your assistant: > “What’s the weather in Beijing?” --- ## 🧩 Available Tools ### `query_weather` ```python query_weather(city: str) -> str ``` Returns a human-readable weather report. Example output: ``` Beijing CN 的天气情况:晴,温度:23°C,湿度:45%,风速:3 m/s ``` --- ## 🚀 Development Clone and run locally: ```bash git clone https://github.com/yourusername/weather-mcp-server.git cd weather-mcp-server uv sync uv run weather-mcp-server ``` --- ## 📄 License MIT License — see [LICENSE](LICENSE) --- ## 🙌 Acknowledgements - [Model Context Protocol](https://modelcontextprotocol.io/) - [OpenWeatherMap](https://openweathermap.org/) - [FastMCP](https://github.com/modelcontextprotocol/python-sdk) --- Made with ☀️ by [Your Name] ``` 📌 **记得修改两处占位符**: 1. `your…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.