Odel
petro-mcp

petro-mcp

Local
@petropt2PythonMITUpdated 1mo ago

MCP server for petroleum engineering: LAS logs, decline curves, PVT, petrophysics, volumetrics.

View on GitHub

petro-mcp

Python 3.10+ License: MIT

A Model Context Protocol server for petroleum engineering calculations.

Install

pip install petro-mcp

Run

petro-mcp                              # start the MCP server (stdio)
petro-mcp --list-tools                 # list available tool groups
petro-mcp --tools las,decline          # load only specific groups
petro-mcp --allowed-paths /data/wells  # restrict file reads to a directory

Tool groups

GroupTools
lasRead LAS 2.0 well log files (header, curves, depth-filtered curve data); compare two or more wells
productionLoad production data from CSV (date, well, oil/gas/water rates)
declineArps decline-curve fitting (exponential, hyperbolic, harmonic); EUR
pvtBubble point, black-oil PVT properties, gas Z-factor
petrophysicsShale volume, density porosity, Archie water saturation, net pay
reservoirVolumetric OOIP/OGIP, recovery factor, P/Z gas material balance
unitsOilfield unit conversion

Dependencies

  • mcp >= 1.0
  • lasio >= 0.31 (LAS file parsing)
  • numpy >= 1.24
  • scipy >= 1.10

License

MIT.