# HoloViz MCP Documentation

Welcome to the HoloViz MCP documentation!

## What is HoloViz MCP?

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

### Key Features

- **📚 Documentation Access**: Search through comprehensive HoloViz documentation
- **🧩 Component Intelligence**: Discover 100+ Panel, hvPlot and HoloViews components with detailed information
- **🤖 Agent Skills**: Augment your LLM or Copilots with HoloViz skills

### Why Use HoloViz MCP?

- **⚡ Faster Development**: Get instant, accurate component information
- **🎨 Better Design**: AI suggests appropriate components for your use case
- **🧠 Smart Context**: Understands your environment and available extensions
- **📖 Always Updated**: Documentation stays current with the ecosystem
- **🔧 Zero Setup**: Works immediately with MCP-compatible AI assistants

## Getting Started

New to HoloViz MCP? Start with our tutorial:

**[Getting Started Tutorial →](tutorials/getting-started.md)**

## Documentation Structure

This documentation follows the [Diataxis](https://diataxis.fr/) framework:

### 📖 [Tutorials](tutorials/getting-started.md)
Learning-oriented guides that take you through a series of steps to complete a project. Perfect for beginners!

- [Getting Started](tutorials/getting-started.md)

### 🔧 [How-To Guides](how-to/installation.md)
Problem-oriented guides that show you how to solve specific problems and accomplish common tasks.

- [Installation](how-to/installation.md)
- [IDE Configuration](how-to/ide-configuration.md)
- [Docker Setup](how-to/docker.md)
- [Configuration](how-to/configuration.md)
- [Serve Apps](how-to/serve-apps.md)
- [Updates & Maintenance](how-to/updates.md)
- [Troubleshooting](how-to/troubleshooting.md)

### 💡 [Explanation](explanation/architecture.md)
Understanding-oriented articles that clarify and illuminate topics, providing background and context.

- [Architecture](explanation/architecture.md)
- [Available Tools](explanation/tools.md)
- [Security Considerations](explanation/security.md)

### 📚 [Reference](reference/holoviz_mcp.md)
Information-oriented technical descriptions of the API and implementation details.

- [API Documentation](reference/holoviz_mcp.md)

## Quick Links

- **GitHub**: [MarcSkovMadsen/holoviz-mcp](https://github.com/MarcSkovMadsen/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/)

## Need Help?

- Check the [Troubleshooting Guide](how-to/troubleshooting.md)
- Join the [HoloViz Discord](https://discord.gg/AXRHnJU6sP)
- Report issues on [GitHub](https://github.com/MarcSkovMadsen/holoviz-mcp/issues)

## Contributing

We welcome contributions! See our [Contributing Guide](contributing.md) for details on how to get started.
