louiscklaw/hko-mcp
Free从香港天文台获取天气信息的基本演示 MCP 服务器。
FreeFree tier
Inputs: textOutputs: text
About louiscklaw/hko-mcp
mcp-hko is an open-source MCP (Model Context Protocol) server that provides access to Hong Kong Observatory (HKO) weather data APIs. It implements a wide range of tools allowing clients to retrieve weather forecasts, current weather reports, earthquake information, tide data, astronomical data, lightning and visibility data, temperature records, radiation levels, rainfall data, and more. Built on the FastMCP framework, the server is designed for easy integration with MCP-compatible clients like Claude Desktop, and can be run via npx or Docker. The repository includes comprehensive tests and documentation for all API functions.
Key Features
9-day Weather Forecast (fnd)
Current Weather Report (rhrread)
Local Weather Forecast (flw)
Weather Warning Information (warningInfo)
Weather Warning Summary (warnsum)
Special Weather Tips (swt)
Quick Earthquake Messages (qem)
Locally Felt Earthquake Report (feltearthquake)
Tide Information (HHOT, HLT)
Astronomical Data (SRS, lunardate)
Pros & Cons
Pros
- Comprehensive access to Hong Kong Observatory weather APIs
- Open source (MIT license) with clear documentation
- Easy to use with Claude Desktop via npx command
- Docker support for containerized deployment
- Includes multiple specialized tools for different data types
- Well-structured code with tests and test watch mode
Cons
- Limited to Hong Kong region weather data only
- Requires internet access to HKO APIs
- May be dependent on HKO API availability and rate limits
- No authentication or API key management for user-specific data
Best For
Retrieve detailed 9-day weather forecasts for Hong KongGet current weather conditions and local forecastsMonitor weather warnings and special weather tips from HKOAccess quick earthquake messages and felt tremor reportsObtain tide predictions, astronomical data (sunrise/sunset, lunar dates)View lightning and visibility data, temperature records, and radiation levelsIntegrate Hong Kong weather data into MCP-compatible AI assistants like Claude Desktop
FAQ
What weather data can I retrieve with mcp-hko?
You can retrieve 9-day forecasts, current weather, local forecasts, weather warnings, earthquake messages, tide info, astronomical data, lightning/visibility data, temperature records, radiation levels, and hourly rainfall, all from the Hong Kong Observatory.
How do I configure mcp-hko for Claude Desktop?
Add the following to your Claude Desktop config: {"mcpServers": {"mcp-hko": {"type": "stdio", "command": "npx", "args": ["-y", "github:louiscklaw/mcp-hko"]}}}
How can I run mcp-hko with Docker?
Use the Docker configuration: {"mcpServers": {"mcp-hko-docker": {"command": "docker", "args": ["run", "-i", "--rm", "mcp-hko:latest"], "name": "mcp-hko (Docker)"}}}
Is mcp-hko free to use?
Yes, it is open source (MIT license) and free to use. You can also run it via npx without payment.