Installation¶

This guide covers different ways to install HoloViz MCP.

Install with uv (Recommended)¶

The recommended installation method uses uv, a fast Python package installer.

Prerequisites¶

First, install uv if you haven't already:

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

For other installation methods, see the uv installation guide.

Install HoloViz MCP¶

Install HoloViz MCP as a uv tool:

uv tool install holoviz-mcp[panel-extensions]

This installs HoloViz MCP with Panel extensions like Material UI, Graphic Walker, and others.

Create Documentation Index¶

After installation, create the documentation index:

uvx holoviz-mcp update

Note: This process takes 5-10 minutes on first run.

Verify Installation¶

Test that the server starts correctly:

uvx holoviz-mcp

Press Ctrl+C to stop the server.

Install with pip¶

You can also install HoloViz MCP using pip:

pip install holoviz-mcp[panel-extensions]

Then create the documentation index:

holoviz-mcp update

Install with conda/mamba¶

HoloViz MCP is available on conda-forge:

conda install -c conda-forge holoviz-mcp

Or with mamba:

mamba install -c conda-forge holoviz-mcp

Then create the documentation index:

holoviz-mcp update

Install from Source¶

For development or to use the latest changes:

git clone https://github.com/MarcSkovMadsen/holoviz-mcp
cd holoviz-mcp
pip install -e .[dev]

Optional Dependencies¶

Panel Extensions¶

Install with common Panel extensions:

uv tool install holoviz-mcp[panel-extensions]

This includes: - panel-material-ui: Material Design components - panel-graphic-walker: Interactive data visualization - panel-full-calendar: Calendar components - panel-neuroglancer: Neuroglancer integration - panel-precision-slider: High-precision sliders - panel-web-llm: WebLLM integration

Development Dependencies¶

For development work:

uv tool install holoviz-mcp[dev]

This includes testing, linting, and documentation tools.

Docker Installation¶

For containerized deployment, see the Docker Guide.

Updating¶

Update with uv¶

uv tool update holoviz-mcp[panel-extensions]

Update Documentation Index¶

After updating the package, refresh the documentation:

holoviz-mcp update

Convenience Aliases¶

Add to your .bashrc or .zshrc:

alias holoviz-mcp="uvx holoviz-mcp"

Uninstalling¶

With uv¶

uv tool uninstall holoviz-mcp

With pip¶

pip uninstall holoviz-mcp

With conda/mamba¶

conda remove holoviz-mcp

Clean Up Data¶

Remove the documentation index and configuration:

rm -rf ~/.holoviz-mcp

Next Steps¶

After installation, configure your IDE: