Hrfco Service
What is Hrfco Service
hrfco-service is a real-time hydrological information query service (MCP Server) that provides access to data related to water levels, rainfall, and dam discharge.
Use cases
Use cases include monitoring water levels in rivers and reservoirs, analyzing rainfall patterns, managing dam operations, and providing data for research in hydrology.
How to use
To use hrfco-service, clone the repository, install the required dependencies, and configure your HRFCO API Key as an environment variable. Then, update the configuration files as needed.
Key features
Key features include real-time querying of water level, rainfall, and dam discharge data, detailed information retrieval by observation station, time series data filtering and statistics, and location information for observation stations.
Where to use
hrfco-service can be used in fields such as environmental monitoring, water resource management, and flood forecasting.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Hrfco Service
hrfco-service is a real-time hydrological information query service (MCP Server) that provides access to data related to water levels, rainfall, and dam discharge.
Use cases
Use cases include monitoring water levels in rivers and reservoirs, analyzing rainfall patterns, managing dam operations, and providing data for research in hydrology.
How to use
To use hrfco-service, clone the repository, install the required dependencies, and configure your HRFCO API Key as an environment variable. Then, update the configuration files as needed.
Key features
Key features include real-time querying of water level, rainfall, and dam discharge data, detailed information retrieval by observation station, time series data filtering and statistics, and location information for observation stations.
Where to use
hrfco-service can be used in fields such as environmental monitoring, water resource management, and flood forecasting.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
HRFCO Service
실시간 수문정보 조회 서비스(MCP Server)
Features
- 수위, 강수량, 댐방류량 등 실시간 수문정보 조회
- 관측소별 상세 정보 조회
- 시계열 데이터 필터링 및 통계
- 관측소 위치 정보 조회
Prerequisites
- Python 3.8+
- Claude Desktop
Installation
-
Install the package:
git clone https://github.com/kwenhwang/hrfco-service.git cd hrfco_service pip install -e . -
Install required dependencies:
pip install -r requirements.txt -
Configure HRFCO API Key:
Windows:
# PowerShell [Environment]::SetEnvironmentVariable("HRFCO_API_KEY", "your-api-key", "User")# Command Prompt setx HRFCO_API_KEY "your-api-key"또는 제어판 > 시스템 > 고급 시스템 설정 > 환경 변수 > 사용자 변수에서 추가
Linux/macOS:
# Add to ~/.bashrc or ~/.zshrc export HRFCO_API_KEY="your-api-key" # Apply changes source ~/.bashrc # or source ~/.zshrc또는 .env 파일 생성:
echo "HRFCO_API_KEY=your-api-key" > .env
Configuration
-
Update
claude_desktop_config.json:{ "mcpServers": { "hrfco": { "command": "C:\\Users\\{USERNAME}\\AppData\\Local\\Programs\\Python\\Python313\\python.exe", "args": [ "-m", "hrfco_service" ], "cwd": "D:\\python\\mcp\\hrfco_service", "env": { "PYTHONPATH": "D:\\python\\mcp\\hrfco_service" } } } } -
Cursor Configuration:
- Open Cursor Settings (Ctrl+,)
- Navigate to Extensions > Python
- Update Python Path to your Python installation:
C:\Users\{USERNAME}\AppData\Local\Programs\Python\Python313\python.exe - Set PYTHONPATH in workspace settings:
{ "python.analysis.extraPaths": [ "D:/python/mcp/hrfco_service" ] }
-
Ensure
HRFCO_API_KEYis set as a system environment variable.
Usage Examples
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
