MCPgee
MCPgee
MCPgeeMCPgee

pyResToolbox Server

v1.0.0•Data Science & ML•stable

Model Context Protocol (MCP) server for AI-powered reservoir engineering calculations. Integrates pyResToolbox with Claude AI for PVT analysis, well performance, simulation support, and more. 47 production-ready tools using industry-standard correlat

pyrestoolboxmcpai-integration
Share:
41
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is pyResToolbox Server?

pyResToolbox Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for ai-powered reservoir engineering calculations. integrates pyrestoolbox with claude ai for pvt analysis, well performance, simulation support, and more. 47 produ...

Model Context Protocol (MCP) server for AI-powered reservoir engineering calculations. Integrates pyResToolbox with Claude AI for PVT analysis, well performance, simulation support, and more. 47 production-ready tools using industry-standard correlat

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Model Context Protocol (MCP) server for AI-powered reservoir

Use Cases

Access reservoir engineering calculations through AI.
Perform PVT analysis and well performance calculations.
gabrielserrao

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx pyrestoolbox

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use pyResToolbox Server

The pyResToolbox MCP Server brings 108 petroleum engineering calculation tools directly into Claude AI via the Model Context Protocol, covering oil and gas PVT analysis, well performance (IPR curves), nodal analysis, decline curve analysis, material balance, geomechanics, and relative permeability. It wraps the open-source pyResToolbox Python library using industry-standard correlations (Valko-McCain, Dranchuk-Abou-Kassem, Corey, LET, and more) so reservoir engineers can run complex subsurface calculations with natural language prompts instead of writing code. Both field and metric unit systems are supported, and results can be used to generate VFPPROD/VFPINJ tables and Arps decline forecasts suitable for export to reservoir simulators.

Prerequisites

  • Python 3.9 or later with the uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
  • Git to clone the repository
  • make (GNU Make) for the provided Makefile shortcuts
  • Claude Desktop or another MCP-compatible client
  • No external API keys required — all calculations run locally
1

Clone the repository

Clone the pyResToolbox MCP server from GitHub to your local machine.

git clone https://github.com/gabrielserrao/pyrestoolbox-mcp.git
cd pyrestoolbox-mcp
2

Install uv and project dependencies

Install the uv package manager if you haven't already, then install all Python dependencies using the provided Makefile target.

curl -LsSf https://astral.sh/uv/install.sh | sh
make uv-install
3

Find the absolute path to uv

Claude Desktop requires absolute paths in its config. Find where uv is installed so you can use it in the configuration file.

which uv
# Common result: /Users/username/.local/bin/uv
4

Configure Claude Desktop

Edit your claude_desktop_config.json with absolute paths to both uv and the cloned repository. Replace placeholders with your actual paths.

{
  "mcpServers": {
    "pyrestoolbox": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/pyrestoolbox-mcp",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}
5

Run tests to verify the installation

Run the included test suite to confirm all 108 tools are working correctly before using them via Claude.

make uv-test
6

Restart Claude Desktop

Fully quit and reopen Claude Desktop. The pyResToolbox tools should now appear and you can start running reservoir engineering calculations.

pyResToolbox Server Examples

Client configuration

claude_desktop_config.json entry using uv to run the pyResToolbox MCP server. Replace paths with your actual absolute paths.

{
  "mcpServers": {
    "pyrestoolbox": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/pyrestoolbox-mcp",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Prompts to try

Example reservoir engineering queries using the 108 available tools.

- "Calculate bubble point pressure for API 35 oil at 180°F with 800 scf/STB GOR and 0.75 gas gravity using Valko-McCain"
- "Generate an IPR curve: Pi=4000 psia, Pb=3500 psia, API 38, 175°F, 75 ft pay, 150 mD permeability, skin=-2, re=1500 ft"
- "Create a SWOF table using Corey correlation with kromax=1.0 and krwmax=0.25"
- "What is the gas Z-factor at 3000 psia and 200°F using Dranchuk-Abou-Kassem?"
- "Run Arps decline analysis with qi=500 STB/day, Di=0.15, b=0.8 for 10 years"
- "Calculate geomechanical fracture gradient at 8000 ft depth with overburden gradient 1.0 psi/ft"

Troubleshooting pyResToolbox Server

Claude Desktop shows the server as disconnected or tools do not appear

Ensure all paths in the config are absolute (no ~ or relative paths). Run 'which uv' to get the exact uv binary path and verify the --directory path points to the cloned pyrestoolbox-mcp folder. Check that 'make uv-install' completed without errors.

Tests fail with import errors or missing dependencies

Run 'make uv-install' again inside the repository directory to ensure all Python packages are installed in the uv virtual environment. If errors persist, try 'uv sync' manually to resolve dependency conflicts.

Calculations return unexpected values or units mismatch

By default, the server uses field units (psia, °F, STB/day, MSCF/day). If you need metric units (barsa, °C, sm³/d), specify 'metric: true' or ask Claude to use metric units explicitly. The tool will switch correlation output accordingly.

Frequently Asked Questions about pyResToolbox Server

What is pyResToolbox Server?

pyResToolbox Server is a Model Context Protocol (MCP) server that model context protocol (mcp) server for ai-powered reservoir engineering calculations. integrates pyrestoolbox with claude ai for pvt analysis, well performance, simulation support, and more. 47 production-ready tools using industry-standard correlat It connects AI assistants to external tools and data sources through a standardized interface.

How do I install pyResToolbox Server?

Follow the installation instructions on the pyResToolbox Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with pyResToolbox Server?

pyResToolbox Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is pyResToolbox Server free to use?

Yes, pyResToolbox Server is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

pyResToolbox Server Alternatives — Similar Data Science & ML Servers

Looking for alternatives to pyResToolbox Server? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.

Ultrarag

★ 5.6k

A Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines

RocketRide

★ 3.1k

📇 🏠 - MCP server that exposes RocketRide AI pipelines as t

Aix Db

★ 2.1k

Aix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。

NeMo Data Designer

★ 1.9k

🎨 NeMo Data Designer: Generate high-quality synthetic data from scratch or from seed data.

PaperBanana

★ 1.7k

Open source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.

MiniMax

★ 1.5k

Bridges MiniMax AI capabilities to the Model Context Protocol, enabling AI agents to perform image understanding, text-to-image generation, and speech synthesis. It provides a standardized interface for accessing MiniMax's core tools via JSON-RPC.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Data Science & MLBrowse All Servers

Quick Config Preview

{ "mcpServers": { "pyrestoolbox": { "command": "npx", "args": ["-y", "pyrestoolbox"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use pyResToolbox Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides