holoviz-mcp 0.4.0__py3-none-any.whl

holoviz_mcp-0.4.0.dist-info/METADATA

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: holoviz-mcp
+Version: 0.4.0
+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
+Requires-Dist: gitpython
+Requires-Dist: matplotlib
+Requires-Dist: nbconvert
+Requires-Dist: packaging
+Requires-Dist: panel
+Requires-Dist: panel-material-ui
+Requires-Dist: plotly
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml
+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: panel-extensions
+Requires-Dist: panel-full-calendar; extra == 'panel-extensions'
+Requires-Dist: panel-graphic-walker; extra == 'panel-extensions'
+Requires-Dist: panel-neuroglancer; extra == 'panel-extensions'
+Requires-Dist: panel-precision-slider; extra == 'panel-extensions'
+Requires-Dist: panel-web-llm; extra == 'panel-extensions'
+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/)**
+
+## ✨ What This Provides
+
+**Documentation Access**: Search through comprehensive HoloViz documentation, including tutorials, reference guides, how-to guides, and API references.
+
+**Component Intelligence**: Discover and understand 100+ Panel components with detailed parameter information, usage examples, and best practices. 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.
+
+## 🚀 Quick Start
+
+### Requirements
+
+- Python 3.11+ and [uv](https://docs.astral.sh/uv/)
+- VS Code with GitHub Copilot, Claude Desktop, Cursor, or any other MCP-compatible client
+
+### Installation
+
+Install HoloViz MCP as a [uv tool](https://docs.astral.sh/uv/concepts/tools/):
+
+```bash
+uv tool install holoviz-mcp[panel-extensions]
+```
+
+Create the documentation index (takes up to 10 minutes on first run):
+
+```bash
+uvx holoviz-mcp update
+```
+
+### Configure Your IDE
+
+**VS Code + GitHub Copilot**: Add this configuration to your `mcp.json`:
+
+```json
+{
+  "servers": {
+    "holoviz": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["holoviz-mcp"]
+    }
+  },
+  "inputs": []
+}
+```
+
+**Claude Desktop**: Add to your configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "holoviz": {
+      "command": "uvx",
+      "args": ["holoviz-mcp"]
+    }
+  }
+}
+```
+
+**Cursor**: Go to `Cursor Settings` → `Features` → `Model Context Protocol` → `Add Server`:
+
+```json
+{
+  "name": "holoviz",
+  "command": "uvx",
+  "args": ["holoviz-mcp"]
+}
+```
+
+Restart your IDE and start asking about Panel components!
+
+### Using Docker
+
+For containerized deployment:
+
+```bash
+# Pull the latest image
+docker pull ghcr.io/marcskovmadsen/holoviz-mcp:latest
+
+# Run with HTTP transport
+docker run -it --rm \
+  -p 8000:8000 \
+  -e HOLOVIZ_MCP_TRANSPORT=http \
+  -v ~/.holoviz-mcp:/root/.holoviz-mcp \
+  ghcr.io/marcskovmadsen/holoviz-mcp:latest
+```
+
+See the [Docker Guide](https://marcskovmadsen.github.io/holoviz-mcp/how-to/docker/) for more details.
+
+## 💡 Example Usage
+
+Ask your AI assistant questions like:
+
+- *"What Panel components are available for user input?"*
+- *"Show me how to create a dashboard with Panel Material UI components"*
+- *"What parameters does the Button component accept?"*
+- *"How do I deploy a Panel application?"*
+
+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.

holoviz_mcp-0.4.0.dist-info/RECORD

@@ -0,0 +1,56 @@
+holoviz_mcp/__init__.py,sha256=81mxQFZOa70OoQ9UOHSzrcC9NnZbca3q9r5rKcuMrIM,485
+holoviz_mcp/cli.py,sha256=3FWUNoYVCAkYfZzLqXH_a7twSSGCPqArsUxWaowWFjk,1823
+holoviz_mcp/client.py,sha256=73IHEDpEYGq5Pk5UsSvo-rOKt2XGPZMNos8h2UmhpYY,2881
+holoviz_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+holoviz_mcp/serve.py,sha256=XRVzSm4DPreBdZQpeVFupLYjCs3_2NFm8nvFjKMzpLE,1055
+holoviz_mcp/server.py,sha256=cZFr9_sEQW1csC-GT74VK53fzj4KhU_X1PAAvfBlc2I,3527
+holoviz_mcp/apps/__init__.py,sha256=Qiius2mdB0CjCRGsJJvfX4JBSkFnED8h4IipavBD32Y,34
+holoviz_mcp/apps/configuration_viewer.py,sha256=4wTcZBXHnLEJmlXSGpAprJzkq1d3TYNh5JSDWbtekCs,4037
+holoviz_mcp/apps/holoviz_get_best_practices.py,sha256=pVooqK4HPSUCEtL_FH_5i98h8-mLbMe5ZKtKvNx7uzs,6467
+holoviz_mcp/apps/holoviz_search.py,sha256=Jm9MlJEU-L4HqSo9BbNbTEoK2H1o2UhD_1JdF738RAA,11390
+holoviz_mcp/apps/hvplot_get_docstring.py,sha256=Ud1-eE3DF2i2Cz6wAHas9aJjAQqxKzL9TEGN0mnOHVQ,9120
+holoviz_mcp/apps/hvplot_get_signature.py,sha256=RmHfQ0m20ghK4XcahhYLo_xOgdCQtQMVFlU3cgRv9_o,8489
+holoviz_mcp/apps/hvplot_list_plot_types.py,sha256=4i6k3puO-z5RQSID8Zh4HJsp9sbr6aX-9SGjwMg2zCw,2577
+holoviz_mcp/apps/panel_get_component.py,sha256=AgezVnBF5j6cvsIheC95rV1o4NXDvn_0WqUHS2BvlRE,18769
+holoviz_mcp/apps/panel_get_component_parameters.py,sha256=xw4xRJw9T2UvlPdQF1JkxRq3PLhEl9OgeTsrBU_Pb-0,17797
+holoviz_mcp/apps/panel_list_components.py,sha256=TESW9D-ILLeN4VcHeeExHM1mud4eAF2EelaVbGf4Gs4,10786
+holoviz_mcp/apps/panel_list_packages.py,sha256=f0Kkgo7JMtECOLtOyXloziRIFaojNUz6u1W4lhbVtWo,2106
+holoviz_mcp/apps/panel_search_components.py,sha256=xAQoa6ChqIhqW4Cibg_uwfFlLrZ2owTbBZ0iB-k2F8g,10402
+holoviz_mcp/config/__init__.py,sha256=ixvS5i6-NiUnHQLknB46r2gCqK74AoIdpfqXDQniu6Y,707
+holoviz_mcp/config/config.yaml,sha256=QdE5aWKtVCM3h469tSKyHIMj3vgUL02_nGMGUgPwZiY,5103
+holoviz_mcp/config/loader.py,sha256=xFJuMjm0t9PWVVV8RB4-JBFmWXykv7kERPlJTsBAzhI,11312
+holoviz_mcp/config/models.py,sha256=HO6bNo4IvPAroXnZbX9k-IT01sx0txzaSfPKKv0WDfA,9018
+holoviz_mcp/config/schema.json,sha256=qFxsZr03bPBPkCqHTY7ecSAVVEGyFRj2EExKKu7_PVg,7367
+holoviz_mcp/config/resources/best-practices/holoviews.md,sha256=TN3WG9yF-520k8EuMwM9dg9W5YGqsgSx7NQetePh9x4,18090
+holoviz_mcp/config/resources/best-practices/hvplot.md,sha256=gEydhz-RzqI91qh5dFjGJ9Tx7XLvhCpQGQ6GrI8nCjU,18934
+holoviz_mcp/config/resources/best-practices/panel-material-ui.md,sha256=McZO7rEmSEukSspVaaqbz3CqiemU3SPbl__Nkdpm6pI,12324
+holoviz_mcp/config/resources/best-practices/panel.md,sha256=DcRe0vKrtBNJQj7FAbKBtabt-JVF1yKVuy3mCspCfgU,24706
+holoviz_mcp/holoviz_mcp/__init__.py,sha256=SrkGEFh3UwvSy1kPKZGWi91DDChrhxP8kiewZWotaP8,24
+holoviz_mcp/holoviz_mcp/data.py,sha256=esoEMKs721cZuewSwUWJQNDOx0SlsP9NgUPx8aar1QM,41188
+holoviz_mcp/holoviz_mcp/models.py,sha256=b1UM4FNBnzxA3LO_0b--WskD0c0BHTqLspgNIwnql88,1174
+holoviz_mcp/holoviz_mcp/pages_design.md,sha256=bLfkZowizkJaQs_zVDsskTUKoOfOadRy6Hr7WMH8P3Q,15055
+holoviz_mcp/holoviz_mcp/server.py,sha256=q0cn9ToOs0GsX4HfwVFyh2pVZjsaIBglWPqkPGCJhFU,8158
+holoviz_mcp/hvplot_mcp/__init__.py,sha256=ypVtR70MsluzGvmfedR3j1wEoQfiq88ZZHka7ztbTpI,25
+holoviz_mcp/hvplot_mcp/server.py,sha256=Krxie7cevS9zTP7IHnVXi6lxjdlV3zFc_GQ2NA10qLU,4721
+holoviz_mcp/panel_mcp/__init__.py,sha256=LVTDu3ARK9E4yIP40W36-DMl2IF6189g6pbGkGUZV4k,564
+holoviz_mcp/panel_mcp/data.py,sha256=nGGWyoK6Qq_-c2q0dKhmL7DEoyQPKxo60KaJ_6ZVeIw,10927
+holoviz_mcp/panel_mcp/models.py,sha256=u7sGtJAtp11Bp3eT8ICRctma52VEAGn1xhEeknFDWMo,5126
+holoviz_mcp/panel_mcp/server.py,sha256=aisg2bSwfFmvTFCHG2DjKzGxOM0TnKgOzt5De4cjgvA,17339
+holoviz_mcp/shared/__init__.py,sha256=_1R5D4cFY_k_albyuvYmguKgjuzuQKbKKGn6tu9z4dM,51
+holoviz_mcp/shared/extract_tools.py,sha256=01vq0HsvueBrbiV5VP3UKpguN8aQzOm0eatUhGRN7cA,2846
+holoviz_mcp/thumbnails/configuration_viewer.png,sha256=aqd6orifdpHZASRli6YNOmaVlP-6COLpapzdNmLrOfQ,42589
+holoviz_mcp/thumbnails/holoviz_get_best_practices.png,sha256=llgLpUp6o_pK5dJg10B1mzkCAw0q1eJ_y5oWZ4BN304,120287
+holoviz_mcp/thumbnails/holoviz_search.png,sha256=kCVxEVEnN4YGcfR0N-UYFGc0D8-7Gb67tQ9QJvEIPgg,259692
+holoviz_mcp/thumbnails/hvplot_get_docstring.png,sha256=bqXgUPQL1JPRsyqrC02i-jfU0A0CbJtKV5xZTKL3J8A,110714
+holoviz_mcp/thumbnails/hvplot_get_signature.png,sha256=cjWmRemcbLDtqiVKGiiwUSLiw0IQ9aRzAFgFc4jXnak,101385
+holoviz_mcp/thumbnails/hvplot_list_plot_types.png,sha256=9XKWRR9KAIK6IHLsRGjJPJqNllTQJMvh3rbVmgdgNC0,44314
+holoviz_mcp/thumbnails/panel_get_component.png,sha256=AS543TivB_wfgDkIp9ugXhBimeWL5rtRbgQ1Ep01O3Q,108412
+holoviz_mcp/thumbnails/panel_get_component_parameters.png,sha256=6Jilq28agX4vbelqlPM4CyjUAwgRr7HpzfVVVGeAPqI,194222
+holoviz_mcp/thumbnails/panel_list_components.png,sha256=rao6IM1lz6nLGY_2ynDq0D7al8lSSisMmySCXgFDCbs,69345
+holoviz_mcp/thumbnails/panel_list_packages.png,sha256=xsGHeblrW1JjUUGCVXTQ_i3tIUmWL0QLnz4nVZE5cz0,17971
+holoviz_mcp/thumbnails/panel_search_components.png,sha256=UYLV_rzIwWF8FKiEO5I7qOmikhdTGcz1yRA2_0yOsXM,127794
+holoviz_mcp-0.4.0.dist-info/METADATA,sha256=G1vLKwNklipQgZ6ssGLKeu0LQjwwwmXPeIOFrUEuxU0,9220
+holoviz_mcp-0.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+holoviz_mcp-0.4.0.dist-info/entry_points.txt,sha256=cf6ATw14C4Ra3PgtlMLX0p9qY_DyY-DIYYurGiGPBTg,57
+holoviz_mcp-0.4.0.dist-info/licenses/LICENSE.txt,sha256=Jqbh7noYJKpAY0CUXf5UeMNtew5vLlLHmRbBrIo6XrE,1515
+holoviz_mcp-0.4.0.dist-info/RECORD,,

holoviz_mcp-0.4.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

holoviz_mcp-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+holoviz-mcp = holoviz_mcp.cli:cli_main

holoviz_mcp-0.4.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,30 @@
+Copyright (c) 2018, HoloViz team (holoviz.org).
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the
+   distribution.
+
+ * Neither the name of the copyright holder nor the names of any
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.