Content
# Weather MCP Server
Real-time weather query MCP server, developed based on the HelloAgents framework.
## Features
- 🌤️ Real-time weather query
- 🌍 Supports 12 major cities
- 🔄 Uses wttr.in API (no key required)
- 🚀 Based on HelloAgents framework
## Installation
```bash
pip install hello-agents requests
```
## Usage
### Direct Run
```bash
python server.py
```
### Usage in Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"weather": {
"command": "python",
"args": ["/path/to/server.py"]
}
}
}
```
### Usage in HelloAgents
```python
from hello_agents import SimpleAgent, HelloAgentsLLM
from hello_agents.tools import MCPTool
agent = SimpleAgent(name="Weather Assistant", llm=HelloAgentsLLM())
weather_tool = MCPTool(server_command=["python", "server.py"])
agent.add_tool(weather_tool)
response = agent.run("What is the weather like in Beijing today?")
```
## API Tools
### get_weather
Get the current weather for a specified city.
**Parameters:**
- `city` (string): City name (supports Chinese and English)
**Example:**
```json
{
"city": "Beijing"
}
```
**Returns:**
```json
{
"city": "Beijing",
"temperature": 10.0,
"feels_like": 9.0,
"humidity": 94,
"condition": "Light rain",
"wind_speed": 1.7,
"visibility": 10.0,
"timestamp": "2025-10-09 13:25:03"
}
```
### list_supported_cities
List all supported cities.
**Returns:**
```json
{
"cities": ["Beijing", "Shanghai", "Guangzhou", "Shenzhen", "Hangzhou", "Chengdu", "Chongqing", "Wuhan", "Xi'an", "Nanjing", "Tianjin", "Suzhou"],
"count": 12
}
```
### get_server_info
Get server information.
**Returns:**
```json
{
"name": "Weather MCP Server",
"version": "1.0.0",
"tools": ["get_weather", "list_supported_cities", "get_server_info"]
}
```
## Supported Cities
Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu, Chongqing, Wuhan, Xi'an, Nanjing, Tianjin, Suzhou
Also supports querying global cities using English city names.
## License
MIT License
## Author
HelloAgents Team
MCP Store