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 を参照してください。