OpenROAD-MCP supports Ubuntu and macOS. This guide covers setup and known issues for each.
./scripts/setup-ubuntu.sh# Install system dependencies
sudo apt-get update
sudo apt-get install -y python3 python3-dev build-essential curl
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
# Install OpenROAD (for integration tests)
# See: https://openroad.readthedocs.io/en/latest/main/GettingStarted.html
# Sync project
uv sync --all-extras --inexact
make test./scripts/setup-macos.sh| Issue | Workaround |
|---|---|
| OpenROAD not available via Homebrew | Use Docker: docker compose up openroad-mcp |
| PTY tests flaky on macOS CI | Run make test (core only); PTY tests are optional |
libomp not found |
brew install libomp |
For testing commands and MCP client compatibility, see the main README.md.