Skip to main content

Build from source

Use a source build to install the development version. For a published version with a prebuilt package, use Get started.

Install build tools

Install uv, Git, and Rust through rustup. The Rust compiler must meet the version requirement in Cargo.toml.

On macOS, install the Xcode Command Line Tools:

xcode-select --install

On Ubuntu, install the build tools and system libraries:

sudo apt-get update
sudo apt-get install -y build-essential git pkg-config libcap-dev libssl-dev libcurl4-openssl-dev binutils

For native Windows, follow Windows build instructions.

Install Console

uv tool install git+https://github.com/posit-dev/mcp-console

This builds Console and its sandbox runner. Preparing R or Python packages from source can require additional system libraries.

To install a specific branch, tag, or commit, append @ and its name or identifier to the URL:

uv tool install git+https://github.com/posit-dev/mcp-console@BRANCH

If your shell cannot find mcp-console, run uv tool update-shell to add uv’s tool directory to PATH, then open a new terminal.

Connect a client

Run the command for your client to register the installed executable:

mcp-console configure-client codex --no-uvx
mcp-console configure-client claude --no-uvx

Restart your client after setup. The --no-uvx option registers the executable by its absolute path. Without it, the client launches uvx mcp-console serve, which may run a published version instead. For other MCP clients, configure a stdio server with the absolute path of the installed mcp-console executable as the command and ["serve"] as the arguments. See client configuration for the remaining options.

Update

Rerun the installation command to fetch the latest commit and rebuild:

uv tool install git+https://github.com/posit-dev/mcp-console

The saved executable path stays the same, so you only need to restart your client.

To work on a local checkout, use the build and validation workflow in Development. The release guide covers native bundle requirements.