petro-mcp
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
| 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.0lasio >= 0.31(LAS file parsing)numpy >= 1.24scipy >= 1.10
License
MIT.