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 --installOn 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 binutilsFor native Windows, follow Windows build instructions.
Install Console
uv tool install git+https://github.com/posit-dev/mcp-consoleThis 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@BRANCHIf 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-uvxRestart 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-consoleThe 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.