Weather MCP Server

Real-time weather query MCP server, developed based on the HelloAgents framework.

Features

• 🌤️ Real-time weather queries

• 🌍 Supports 12 major Chinese cities

• 🔄 Uses wttr.in API (no API key required)

• 🚀 Based on the HelloAgents framework

Related MCP server: Weather MCP Server

Installation

pip install hello-agents requests

Usage

Run Directly

python server.py

Use in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}

Use in HelloAgents

from hello_agents import SimpleAgent, HelloAgentsLLM
from hello_agents.tools import MCPTool

agent = SimpleAgent(name="天气助手", llm=HelloAgentsLLM())
weather_tool = MCPTool(server_command=["python", "server.py"])
agent.add_tool(weather_tool)

response = agent.run("北京今天天气怎么样？")

API Tools

get_weather

Get the current weather for a specified city.

Parameters:

• city (string): City name (supports both Chinese and English)

Example:

{
  "city": "北京"
}

Response:

{
  "city": "北京",
  "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 Chinese cities.

Response:

{
  "cities": ["北京", "上海", "广州", "深圳", "杭州", "成都", "重庆", "武汉", "西安", "南京", "天津", "苏州"],
  "count": 12
}

get_server_info

Get server information.

Response:

{
  "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 any city globally using English city names.

License

MIT License

Author

HelloAgents Team