# ✨ HoloViz MCP

[![CI](https://img.shields.io/github/actions/workflow/status/MarcSkovMadsen/holoviz-mcp/ci.yml?style=flat-square&branch=main)](https://github.com/MarcSkovMadsen/holoviz-mcp/actions/workflows/ci.yml)
[![Docker](https://img.shields.io/github/actions/workflow/status/MarcSkovMadsen/holoviz-mcp/docker.yml?style=flat-square&branch=main&label=docker)](https://github.com/MarcSkovMadsen/holoviz-mcp/actions/workflows/docker.yml)
[![conda-forge](https://img.shields.io/conda/vn/conda-forge/holoviz-mcp?logoColor=white&logo=conda-forge&style=flat-square)](https://prefix.dev/channels/conda-forge/packages/holoviz-mcp)
[![pypi-version](https://img.shields.io/pypi/v/holoviz-mcp.svg?logo=pypi&logoColor=white&style=flat-square)](https://pypi.org/project/holoviz-mcp)
[![python-version](https://img.shields.io/pypi/pyversions/holoviz-mcp?logoColor=white&logo=python&style=flat-square)](https://pypi.org/project/holoviz-mcp)
[![docs](https://img.shields.io/badge/docs-read-blue?style=flat-square)](https://marcskovmadsen.github.io/holoviz-mcp/)

A comprehensive [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides intelligent access to the [HoloViz](https://holoviz.org/) ecosystem, enabling AI assistants to help you build interactive dashboards and data visualizations with [Panel](https://panel.holoviz.org/), [hvPlot](https://hvplot.holoviz.org), [Lumen](https://lumen.holoviz.org/), [Datashader](https://datashader.org/) and your favorite Python libraries.

[![HoloViz Logo](https://holoviz.org/assets/holoviz-logo-stacked.svg)](https://holoviz.org)

**📖 [Full Documentation](https://marcskovmadsen.github.io/holoviz-mcp/)** | **🚀 [Quick Start](https://marcskovmadsen.github.io/holoviz-mcp/tutorials/getting-started/)** | **🐳 [Docker Guide](https://marcskovmadsen.github.io/holoviz-mcp/how-to/docker/)** | **🤗 [Explore the Tools](https://huggingface.co/spaces/awesome-panel/holoviz-mcp-ui)**

## ✨ What This Provides

**Documentation Access**: Search through comprehensive HoloViz documentation, including tutorials, reference guides, how-to guides, and API references.

**Display Server**: Create and share Python visualizations with instant URLs. The `show` tool executes code in an isolated server and provides web-accessible visualizations that you can view, share, and manage.

**Agents Skills**: Agents and Skills for LLMs.

**Component Intelligence**: Discover and understand 100+ Panel components with detailed parameter information and usage examples. Similar features are available for hvPlot.

**Extension Support**: Automatic detection and information about Panel extensions such as Material UI, Graphic Walker, and other community packages.

**Smart Context**: Get contextual code assistance that understands your development environment and available packages.

## 🎯 Why Use This?

- **⚡ Faster Development**: No more hunting through docs - get instant, accurate component information.
- **🎨 Better Design**: AI suggests appropriate components and layout patterns for your use case.
- **🧠 Smart Context**: The assistant understands your environment and available Panel extensions.
- **📖 Always Updated**: Documentation stays current with the latest HoloViz ecosystem changes.
- **🔧 Zero Setup**: Works immediately with any MCP-compatible AI assistant.

## 🛠️ Agent Skills (Standalone)

The HoloViz MCP skills follow the [Agent Skills specification](https://agentskills.io) and can be installed standalone — without running the MCP server — using any skills package manager.

Available skills: `panel`, `hvplot`, `holoviews`, `param`, `panel-material-ui`, `panel-custom-components`, `panel-holoviews`, `holoviz-mcp-cli`

**With [agr](https://github.com/kasperjunge/agent-resources):**

```bash
pip install agr
agr add MarcSkovMadsen/holoviz-mcp/panel
```

**With [Vercel skills](https://github.com/vercel-labs/skills):**

```bash
npx skills add MarcSkovMadsen/holoviz-mcp --skill panel
```

**With [openskills](https://github.com/numman-ali/openskills):**

```bash
npx openskills install MarcSkovMadsen/holoviz-mcp/panel
```

**Manually:** Copy the `skills/<name>/SKILL.md` file into your agent's skills directory (e.g., `.claude/skills/`).

Watch the [HoloViz MCP Introduction](https://youtu.be/M-YUZWEeSDA) on YouTube to see it in action.

[![HoloViz MCP Introduction](docs/assets/images/holoviz-mcp-introduction.png)](https://youtu.be/M-YUZWEeSDA)

## 📚 Learn More

Check out the [`holoviz-mcp` documentation](https://marcskovmadsen.github.io/holoviz-mcp/):

- **[Tutorials](https://marcskovmadsen.github.io/holoviz-mcp/tutorials/getting-started/)**: Step-by-step guides to get you started
- **[How-To Guides](https://marcskovmadsen.github.io/holoviz-mcp/how-to/installation/)**: Practical guides for common tasks
- **[Explanation](https://marcskovmadsen.github.io/holoviz-mcp/explanation/architecture/)**: Understanding concepts and architecture
- **[Reference](https://marcskovmadsen.github.io/holoviz-mcp/reference/holoviz_mcp/)**: API documentation and technical details

## ❤️ Contributing

We welcome contributions! See our [Contributing Guide](https://marcskovmadsen.github.io/holoviz-mcp/contributing/) for details.

## 📄 License

HoloViz MCP is licensed under the [BSD 3-Clause License](LICENSE.txt).

## 🔗 Links

- **GitHub**: [MarcSkovMadsen/holoviz-mcp](https://github.com/MarcSkovMadsen/holoviz-mcp)
- **Documentation**: [marcskovmadsen.github.io/holoviz-mcp](https://marcskovmadsen.github.io/holoviz-mcp/)
- **PyPI**: [pypi.org/project/holoviz-mcp](https://pypi.org/project/holoviz-mcp)
- **Docker**: [ghcr.io/marcskovmadsen/holoviz-mcp](https://github.com/MarcSkovMadsen/holoviz-mcp/pkgs/container/holoviz-mcp)
- **HoloViz Community**: [Discord](https://discord.gg/AXRHnJU6sP) | [Discourse](https://discourse.holoviz.org/)

---

**Note**: This MCP server can execute arbitrary Python code when serving Panel applications (configurable, enabled by default). See [Security Considerations](https://marcskovmadsen.github.io/holoviz-mcp/explanation/security/) for details.