pyResToolbox
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
What is pyResToolbox?
pyResToolbox 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
Maintainer
Works with
Installation
Manual Installation
npx pyrestoolbox-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use pyResToolbox
pyResToolbox MCP Server integrates the pyResToolbox petroleum engineering library with AI assistants via the Model Context Protocol, exposing 108 production-ready tools for reservoir engineering workflows. It covers Oil and Gas PVT analysis, well performance (IPR curves, VLP correlations), decline curve analysis (Arps, Duong), material balance, geomechanics, relative permeability tables, and heterogeneity metrics — all using industry-standard correlations. Engineers can run complete reservoir studies, generate simulation input tables, and compare analytical methods interactively through natural language without switching between spreadsheets or Python scripts.
Prerequisites
- Python 3.10 or newer installed on your machine
- UV package manager (recommended) or pip — install UV via: curl -LsSf https://astral.sh/uv/install.sh | sh
- Claude Desktop or another MCP-compatible client
- Git to clone the repository
- No external API keys required — the library runs entirely locally
Clone the repository
Clone the pyrestoolbox-mcp repository to your local machine and enter the project directory.
git clone https://github.com/gabrielserrao/pyrestoolbox-mcp.git
cd pyrestoolbox-mcpInstall dependencies with UV
Install the Python dependencies using UV (10-100x faster than pip). The project uses FastMCP 3.1+ as its MCP framework.
make uv-install && make uv-testFind your UV binary absolute path
Claude Desktop is a GUI app and does not inherit your terminal PATH. You must use the absolute path to the UV binary in the config — never use ~ or relative paths.
which uv
# Example output: /Users/yourname/.local/bin/uvConfigure Claude Desktop
Open your Claude Desktop config file and add the pyrestoolbox server. Replace the paths with your actual absolute paths to the uv binary and the cloned project directory.
{
"mcpServers": {
"pyrestoolbox": {
"command": "/Users/yourname/.local/bin/uv",
"args": [
"run",
"--directory",
"/Users/yourname/projects/pyrestoolbox-mcp",
"fastmcp",
"run",
"server.py"
]
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop so it picks up the new MCP server configuration. You should see the pyrestoolbox tools available in the tool list.
pyResToolbox Examples
Client configuration
Claude Desktop config block for pyResToolbox MCP Server using UV runner with absolute paths.
{
"mcpServers": {
"pyrestoolbox": {
"command": "/Users/yourname/.local/bin/uv",
"args": [
"run",
"--directory",
"/Users/yourname/projects/pyrestoolbox-mcp",
"fastmcp",
"run",
"server.py"
]
}
}
}Prompts to try
These prompts demonstrate the reservoir engineering capabilities across PVT, well performance, and simulation table generation.
- "Calculate bubble point pressure for 35° API oil at 180°F with 800 scf/stb solution GOR and 0.75 gas gravity"
- "Compare Z-factors using DAK, HY, and WYW methods for gas SG 0.7 at 3500 psia, 180°F"
- "Generate IPR curve: Pi=4000 psia, Pb=3500 psia, API 38, 175°F, 75 ft pay, 150 mD, skin=-2"
- "Create SWOF relative permeability table using Corey with 25 rows, kromax=1.0, swc=0.15, sorw=0.15"
- "Run complete reservoir analysis: bubble point, PVT table, and IPR curve for 38° API oil at 175°F, Pi=4000 psia"Troubleshooting pyResToolbox
Claude Desktop cannot find the uv command or server fails to start
GUI applications do not inherit your shell PATH. Run 'which uv' in your terminal to get the absolute path and use that exact path in the 'command' field of the config — never use ~ or relative paths.
Tools appear but calculations return unexpected results
The server defaults to Field units (psia, °F, ft, mD). If you need metric results, include 'metric: true' in your prompt or ask the AI to switch to metric units (barsa, °C, m).
make uv-install fails with dependency errors
Ensure Python 3.10 or newer is active. Run 'python --version' to check. If using pyenv or conda, activate the correct environment before running make commands.
Frequently Asked Questions about pyResToolbox
What is pyResToolbox?
pyResToolbox 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?
Follow the installation instructions on the pyResToolbox GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with pyResToolbox?
pyResToolbox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is pyResToolbox free to use?
Yes, pyResToolbox is open source and available under the GPL 3.0 license. You can use it freely in both personal and commercial projects.
pyResToolbox Alternatives — Similar Data Science & ML Servers
Looking for alternatives to pyResToolbox? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.
Ultrarag
★ 5.6kA 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.1kAix-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.7kOpen 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.5kBridges 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.
Set Up pyResToolbox in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use pyResToolbox?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.