Petromcp

What is Petromcp?

Petromcp is a local-first MCP server that lets Claude read LAS well log files directly. It wraps open-source parsers like lasio and exposes them as MCP tools, enabling natural conversation with petroleum data without copy-pasting curve values.

How to use Petromcp?

Requires Python 3.10+, uv, and Claude Desktop. After cloning the repo and running make setup and make install-claude, configure an allowlist of directories Petromcp can read using the CLI subcommands petromcp config init and petromcp config add-path. Restart Claude Desktop, then ask questions like "What's wrong with this well log?" in a new conversation.

Key features of Petromcp

• MCP tools for reading, summarizing, and comparing LAS files
• Unit conversion between common petroleum units (ft↔m, psi↔kPa, etc.)
• Built-in qc_a_well_log prompt for standard QC workflow
• Strict file allowlist – cannot read outside allowed directories
• Zero telemetry, no automatic updates, runs entirely on your machine
• Ships with synthetic sample data for testing without real files

Use cases of Petromcp

• Diagnose well log quality issues by asking Claude to read and analyze a LAS file
• Compare two wells for common curves, depth overlap, and unit consistency
• Convert units (e.g., psi to kPa) during data interpretation
• Walk through a standardized QC pass using the built-in prompt
• Explore LAS files without installing specialized petroleum software

FAQ from Petromcp

How does Petromcp protect my data?

Petromcp runs locally and refuses to read any file outside an explicit allowlist you configure. It contains no telemetry, no phone-home, and no automatic updates.

What dependencies does Petromcp require?

It requires Python 3.10+, uv (the Astral package manager), and the Claude Desktop application.

Where does Petromcp store my data?

All data remains on your machine. Petromcp only reads files from directories you explicitly add to its allowlist via petromcp config add-path.

What file formats does Petromcp support?

Currently, Petromcp supports LAS well log files (v0.2). Support for DLIS, SEG-Y, and pump card data is planned for future releases.

How do I invoke Petromcp tools?

Once installed and configured, open a new conversation in Claude Desktop and ask plain-language questions about your well logs. Claude automatically selects the appropriate MCP tool (e.g., read_las_file, summarize_las_curves, compare_well_logs) and reads the file through Petromcp.