Skip to content

Updates & Maintenance

Keep HoloViz MCP up to date to ensure you have the latest features, bug fixes, and documentation.

Update the Python Package

Update the HoloViz MCP package:

uv tool update holoviz-mcp[panel-extensions]

With pip

pip install --upgrade holoviz-mcp[panel-extensions]

With conda/mamba

conda update -c conda-forge holoviz-mcp

Update the Documentation Index

After updating the package, refresh the documentation index:

uvx holoviz-mcp update

This ensures you have the latest documentation from HoloViz projects.

Combined Update

For convenience, update both the package and documentation:

uv tool update holoviz-mcp[panel-extensions] && uvx holoviz-mcp update

Update Docker Image

Pull Latest Image

docker pull ghcr.io/marcskovmadsen/holoviz-mcp:latest

Update Running Container

If using Docker Compose:

docker-compose pull
docker-compose down
docker-compose up -d

Update Documentation in Container

Run the update command in the container:

docker exec -it holoviz-mcp holoviz-mcp update

Or set UPDATE_DOCS=true when starting:

docker run -it --rm \
  -e UPDATE_DOCS=true \
  -v ~/.holoviz-mcp:/root/.holoviz-mcp \
  ghcr.io/marcskovmadsen/holoviz-mcp:latest

Check Versions

Check Package Version

uvx holoviz-mcp --version

Or with pip:

pip show holoviz-mcp

Check Documentation Index Version

The documentation index includes version information in ~/.holoviz-mcp/.

Update Frequency

  • Package Updates: Monthly or when new features are released
  • Documentation Updates: Weekly or before starting a new project
  • Docker Images: Pull latest before each use

When to Update

Update when:

  • New HoloViz releases are announced
  • You encounter bugs that may be fixed in newer versions
  • New Panel extensions are released
  • Documentation seems outdated

Rollback

Rollback Package

If an update causes issues, rollback to a previous version:

uv tool install holoviz-mcp[panel-extensions]==0.1.0

Replace 0.1.0 with the desired version.

Restore Documentation Index

If the documentation index gets corrupted:

rm -rf ~/.holoviz-mcp/chroma
uvx holoviz-mcp update

Automatic Updates

GitHub Dependabot

If using HoloViz MCP in a project, configure Dependabot:

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "pip"
    directory: "/"
    schedule:
      interval: "weekly"

Maintenance Tasks

Clean Up Old Data

Remove unused data:

# Remove documentation index
rm -rf ~/.holoviz-mcp/chroma

# Recreate
uvx holoviz-mcp update

Verify Installation

After updates, verify everything works:

# Test server starts
uvx holoviz-mcp

# Check in IDE
# Ask your AI assistant about Panel components

Next Steps