HRFCO Service

HRFCOサービス

リアルタイム水文情報照会サービス（MCP Server）

Features

• 水位、降水量、ダム放流量などリアルタイム水門情報の照会
• 観測所別詳細情報の照会
• 時系列データのフィルタリングと統計
• 観測所の位置情報の照会

Prerequisites

• Python 3.8+
• Claude Desktop

Installation

1. Install the package:
   git clone https://github.com/kwenhwang/hrfco-service.git cd hrfco_service pip install -e .
2. Install required dependencies:
   pip install -r requirements.txt
3. 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

構成

1. 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" } } } }
2. 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"] }
3. Ensure HRFCO_API_KEY is set as a system environment variable.

Usage Examples