HRFCOサービス

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

Features

• 水位、降水量、ダム放流量などリアルタイム水門情報の照会

• 観測所別詳細情報の照会

• 時系列データのフィルタリングと統計

• 観測所の位置情報の照会

Related MCP server: Weather Server

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