Metadata-Version: 2.4
Name: holoviz-mcp
Version: 0.17.1
Summary: A Model Context Protocol (MCP) server for the HoloViz ecosystem
Project-URL: Homepage, https://github.com/MarcSkovMadsen/holoviz-mcp
Project-URL: Source, https://github.com/MarcSkovMadsen/holoviz-mcp
Author-email: MarcSkovMadsen <marc.skov.madsen@gmail.com>
Maintainer-email: MarcSkovMadsen <marc.skov.madsen@gmail.com>
License: BSD
License-File: LICENSE.txt
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: certifi
Requires-Dist: chromadb
Requires-Dist: fastmcp<4,>=3.0
Requires-Dist: gitpython
Requires-Dist: hvplot
Requires-Dist: hvsampledata
Requires-Dist: matplotlib
Requires-Dist: nbconvert
Requires-Dist: packaging
Requires-Dist: panel
Requires-Dist: panel-full-calendar
Requires-Dist: panel-graphic-walker
Requires-Dist: panel-material-ui
Requires-Dist: panel-neuroglancer
Requires-Dist: panel-precision-slider
Requires-Dist: panel-splitjs
Requires-Dist: panel-web-llm
Requires-Dist: playwright
Requires-Dist: plotly
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: typer
Requires-Dist: watchfiles
Provides-Extra: dev
Requires-Dist: ipykernel; extra == 'dev'
Requires-Dist: mkdocs; extra == 'dev'
Requires-Dist: mkdocs-material; extra == 'dev'
Requires-Dist: mkdocs-pycafe; extra == 'dev'
Requires-Dist: mkdocstrings[python]; extra == 'dev'
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Requires-Dist: pytest-rerunfailures; extra == 'dev'
Requires-Dist: pytest-xdist; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Provides-Extra: mypy
Requires-Dist: mypy; extra == 'mypy'
Requires-Dist: types-requests; extra == 'mypy'
Requires-Dist: typing-extensions; extra == 'mypy'
Provides-Extra: pydata
Requires-Dist: altair; extra == 'pydata'
Requires-Dist: duckdb; extra == 'pydata'
Requires-Dist: ipywidgets-bokeh; extra == 'pydata'
Requires-Dist: polars; extra == 'pydata'
Requires-Dist: pyarrow; extra == 'pydata'
Requires-Dist: pytest; extra == 'pydata'
Requires-Dist: scikit-learn; extra == 'pydata'
Requires-Dist: seaborn; extra == 'pydata'
Requires-Dist: setuptools; extra == 'pydata'
Requires-Dist: shapely; extra == 'pydata'
Requires-Dist: vega-datasets; extra == 'pydata'
Requires-Dist: yfinance; extra == 'pydata'
Description-Content-Type: text/markdown

# ✨ 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.
