Weather MCP Server

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

Features

• 🌤️ Real-time weather query

• 🌍 Supports 12 major Chinese cities

• 🔄 Uses the 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

Using 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"]
    }
  }
}

Using 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 Chinese and English)

Example:

{
  "city": "北京"
}

Return:

{
  "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.

Return:

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

get_server_info

Get server information.

Return:

{
  "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, Suzhou, Tianjin

English city names are also supported for querying any city worldwide.

License

MIT License

Author

HelloAgents Team