EPANET MCP Server

MCP 서버로, EPANET 수리/수질 엔진을 AI 어시스턴트(Claude Desktop, Cursor, VS Code Copilot, Claude Code, …) 앞에 stdio로 제공합니다 — 클라우드 왕복 없음, 브라우저 없음.

AI 어시스턴트가 EPANET .inp/.net 모델을 로드하고, 검사하고, 시뮬레이션을 실행하고, 노드/링크별 결과를 읽고, 검증된 편집을 모두 로컬에서 수행할 수 있게 합니다.

도구

• 네트워크 I/O — load_network, save_network, list_networks

• 검사 — get_network_summary, get_nodes, get_links, get_coordinates

• 시뮬레이션 — run_simulation, get_node_results, get_link_results

• 변경 (엔진 검증, 결과 무효화) — set_pipe_diameter, set_junction_demand, set_pump_speed, set_valve_setting, set_node_elevation, set_demand_pattern, add_tank, remove_tank, add_valve

• 모델 구축 — create_network, assign_demands, sample_elevations, fetch_road_network, generate_network_from_bbox

• 설계 도우미 — lookup_pipe_diameters, recommend_diameter, friction_loss, calculate_minor_loss, pipe_sizing_wizard, pump_selection, list_fitting_kfactors

• 최적화 — optimize_network, run_candidate

generate_network_from_bbox는 경계 상자에 대해 실제 OpenStreetMap 도로 데이터에서 절점/관로 골격을 자동으로 배치하며, 가장 가까운 수로에 저수지를 배치하고 지반 고도는 번들된 IFSAR 10 m DEM에서 샘플링합니다.

Related MCP server: idfkit-mcp

사전 요구 사항

설치

npm install

로컬 실행

서버가 읽고(load_network) 쓰는(save_network) 데이터 디렉터리는 경로 제한이 있습니다 — 서버는 그 외부의 파일을 거부합니다.

mkdir -p data
cp your-model.inp data/
export EPANET_DATA_DIR=$(pwd)/data
npm start

서버는 부팅 후 stdio에서 클라이언트를 기다립니다.

AI 앱에 연결

Claude Desktop

claude_desktop_config.json을 편집하세요 (Windows에서는 %APPDATA%\Claude\claude_desktop_config.json, macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "epanet": {
      "command": "npm",
      "args": ["start"],
      "cwd": "<absolute path to this repo>",
      "env": {
        "EPANET_DATA_DIR": "<absolute path to this repo>/data"
      }
    }
  }
}

Cursor / VS Code

동일한 형식이 Cursor (%APPDATA%\Cursor\User\globalStorage\mcp.json) 또는 VS Code (%APPDATA%\Code\User\mcp.json)에서 작동합니다 — command: "npm", 동일한 args/env.

구성

서버는 다음 환경 변수를 읽습니다:

인증은 기본적으로 꺼져 있습니다. EPANET_AUTH_* 변수를 설정하여 서버를 RS256 베어러 토큰으로 보호하세요.

테스트

npm test

단위 테스트는 커밋된 .inp 픽스처를 대상으로 인메모리 MCP 전송을 구동합니다 — 실행 중인 서버가 필요하지 않습니다.

패키지 설치 프로그램 빌드

npm run package:win    # or package:mac / package:linux

dist/ 아래에 자체 포함 설치 프로그램(번들된 Node 런타임, 시스템 Node 불필요)을 생성합니다.

라이선스

MIT — LICENSE를 참조하세요.