petro-mcp

petro-mcp

A Model Context Protocol server for petroleum engineering calculations.

⚠️ Version notice — do not use pre-1.0.0 releases. Every version before 1.0.0 has been withdrawn: those releases contain critical calculation errors that can produce incorrect engineering results, and their artifacts have been removed from PyPI. Install only 1.0.0 or later — pip install "petro-mcp>=1.0.0". Any copy of an older version obtained from a mirror, cache, or third-party listing should be discarded.

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

Group	Tools
las	Read LAS 2.0 well log files (header, curves, depth-filtered curve data); compare two or more wells
production	Load production data from CSV (date, well, oil/gas/water rates)
decline	Arps decline-curve fitting (exponential, hyperbolic, harmonic); EUR
pvt	Bubble point, black-oil PVT properties, gas Z-factor
petrophysics	Shale volume, density porosity, Archie water saturation, net pay
reservoir	Volumetric OOIP/OGIP, recovery factor, P/Z gas material balance
units	Oilfield unit conversion

Dependencies

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

License

MIT.