vizro-mcp 0.1.0__tar.gz → 0.1.1__tar.gz

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/CHANGELOG.md

@@ -1,3 +1,11 @@
+<a id='changelog-0.1.1'></a>
+
+# 0.1.1 — 2025-05-15
+
+### Fixed
+
+- Fix name conflict with `langchain` by avoiding use of conflicting parameter names in tools. ([#1177](https://github.com/mckinsey/vizro/pull/1177))
+
 <a id='changelog-0.1.0'></a>
 
 # 0.1.0 — 2025-05-06

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vizro-mcp
-Version: 0.1.0
+Version: 0.1.1
 Summary: MCP server to help create Vizro dashboards and charts
 Author: Vizro Team
 License-File: LICENSE.txt
@@ -17,10 +17,16 @@ Requires-Dist: pandas[excel,html,parquet]
 Requires-Dist: vizro==0.1.38
 Description-Content-Type: text/markdown
 
+<a href="https://glama.ai/mcp/servers/@mckinsey/vizro">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@mckinsey/vizro/badge" />
+</a>
+
 # Vizro MCP server
 
 Vizro-MCP is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server, which works alongside a LLM to help you create Vizro dashboards and charts.
 
+![Vizro MCP Demo](assets/vizro-mcp.gif)
+
 ## Features of Vizro-MCP
 
 Vizro-MCP provides tools and templates to create a functioning Vizro chart or dashboard step by step. Benefits include:
@@ -60,10 +66,27 @@ In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications
 
 > ⚠️ **Warning:** In some hosts (like Claude Desktop) the free plan might be less performant, which may cause issues when the request is too complex. In cases where the request causes the UI to crash, opt for using a paid plan, or reduce your request's complexity.
 
-## Setup Instructions
+### Setup Instructions
+
+The general server config is mostly the same for all hosts:
+
+```json
+{
+  "mcpServers": {
+    "vizro-mcp": {
+      "command": "uvx",
+      "args": [
+        "vizro-mcp"
+      ]
+    }
+  }
+}
+```
+
+In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications but we recommend Claude Desktop or Cursor as popular choices (see more detailed instructions below). Different AI tools may use different setup methods or connection settings. Check each tool's docs for details.
 
 <details>
-<summary><strong>Claude</strong></summary>
+<summary><strong>Claude Desktop</strong></summary>
 
 Add the following to your `claude_desktop_config.json` [found via Developer Settings](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server).
 
@@ -114,8 +137,6 @@ Similarly, when using Cursor, after a short pause, you should see a green light
 
 </details>
 
-In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications but we recommend Claude Desktop or Cursor as popular choices. Different AI tools may use different setup methods or connection settings. Check each tool's docs for details.
-
 ## 💻 Usage
 
 ### Use prompt templates to get specific dashboards quickly

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/README.md

@@ -1,7 +1,13 @@
+<a href="https://glama.ai/mcp/servers/@mckinsey/vizro">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@mckinsey/vizro/badge" />
+</a>
+
 # Vizro MCP server
 
 Vizro-MCP is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server, which works alongside a LLM to help you create Vizro dashboards and charts.
 
+![Vizro MCP Demo](assets/vizro-mcp.gif)
+
 ## Features of Vizro-MCP
 
 Vizro-MCP provides tools and templates to create a functioning Vizro chart or dashboard step by step. Benefits include:
@@ -41,10 +47,27 @@ In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications
 
 > ⚠️ **Warning:** In some hosts (like Claude Desktop) the free plan might be less performant, which may cause issues when the request is too complex. In cases where the request causes the UI to crash, opt for using a paid plan, or reduce your request's complexity.
 
-## Setup Instructions
+### Setup Instructions
+
+The general server config is mostly the same for all hosts:
+
+```json
+{
+  "mcpServers": {
+    "vizro-mcp": {
+      "command": "uvx",
+      "args": [
+        "vizro-mcp"
+      ]
+    }
+  }
+}
+```
+
+In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications but we recommend Claude Desktop or Cursor as popular choices (see more detailed instructions below). Different AI tools may use different setup methods or connection settings. Check each tool's docs for details.
 
 <details>
-<summary><strong>Claude</strong></summary>
+<summary><strong>Claude Desktop</strong></summary>
 
 Add the following to your `claude_desktop_config.json` [found via Developer Settings](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server).
 
@@ -95,8 +118,6 @@ Similarly, when using Cursor, after a short pause, you should see a green light
 
 </details>
 
-In principle, the Vizro MCP server works with _any_ MCP enabled LLM applications but we recommend Claude Desktop or Cursor as popular choices. Different AI tools may use different setup methods or connection settings. Check each tool's docs for details.
-
 ## 💻 Usage
 
 ### Use prompt templates to get specific dashboards quickly

vizro_mcp-0.1.1/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["maxschulz-COL", "lingyielia"]
+}

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/src/vizro_mcp/__init__.py

@@ -3,7 +3,7 @@ import sys
 
 from .server import mcp
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 
 def main():

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/src/vizro_mcp/server.py

@@ -99,7 +99,7 @@ def get_sample_data_info(data_name: Literal["iris", "tips", "stocks", "gapminder
 
 @mcp.tool()
 def validate_model_config(
-    config: dict[str, Any],
+    dashboard_config: dict[str, Any],
     data_infos: list[DFMetaData],  # Should be Optional[..]=None, but Cursor complains..
     auto_open: bool = True,
 ) -> ValidationResults:
@@ -109,7 +109,7 @@ def validate_model_config(
     The PyCafe link will be automatically opened in your default browser if auto_open is True.
 
     Args:
-        config: Either a JSON string or a dictionary representing a Vizro model configuration
+        dashboard_config: Either a JSON string or a dictionary representing a Vizro dashboard model configuration
         data_infos: List of DFMetaData objects containing information about the data files
         auto_open: Whether to automatically open the PyCafe link in a browser
 
@@ -119,7 +119,7 @@ def validate_model_config(
     Vizro._reset()
 
     try:
-        dashboard = vm.Dashboard.model_validate(config)
+        dashboard = vm.Dashboard.model_validate(dashboard_config)
     except ValidationError as e:
         return ValidationResults(
             valid=False,
@@ -333,14 +333,14 @@ Create an EDA dashboard based on the following dataset:{file_path_or_url}. Proce
 
 @mcp.tool()
 def validate_chart_code(
-    config: ChartPlan,
+    chart_config: ChartPlan,
     data_info: DFMetaData,
     auto_open: bool = True,
 ) -> ValidationResults:
     """Validate the chart code created by the user and optionally open the PyCafe link in a browser.
 
     Args:
-        config: A ChartPlan object with the chart configuration
+        chart_config: A ChartPlan object with the chart configuration
         data_info: Metadata for the dataset to be used in the chart
         auto_open: Whether to automatically open the PyCafe link in a browser
 
@@ -350,7 +350,7 @@ def validate_chart_code(
     Vizro._reset()
 
     try:
-        chart_plan_obj = ChartPlan.model_validate(config)
+        chart_plan_obj = ChartPlan.model_validate(chart_config)
     except ValidationError as e:
         return ValidationResults(
             valid=False,

{vizro_mcp-0.1.0 → vizro_mcp-0.1.1}/tests/unit/vizro_mcp/test_server.py

@@ -200,7 +200,7 @@ class TestValidateModelConfig:
         self, valid_dashboard_config: dict[str, Any], dashboard_config_validation_result: ValidationResults
     ) -> None:
         """Test successful validation of a dashboard configuration."""
-        result = validate_model_config(config=valid_dashboard_config, data_infos=[], auto_open=False)
+        result = validate_model_config(dashboard_config=valid_dashboard_config, data_infos=[], auto_open=False)
 
         # Compare everything but the pycafe_url
         assert result.valid == dashboard_config_validation_result.valid
@@ -219,7 +219,9 @@ class TestValidateModelConfig:
         iris_metadata: DFMetaData,
     ) -> None:
         """Test validation of a dashboard with a scatter graph component."""
-        result = validate_model_config(config=graph_dashboard_config, data_infos=[iris_metadata], auto_open=False)
+        result = validate_model_config(
+            dashboard_config=graph_dashboard_config, data_infos=[iris_metadata], auto_open=False
+        )
 
         # Compare everything but the pycafe_url
         assert result.valid == graph_dashboard_validation_result.valid
@@ -237,7 +239,7 @@ class TestValidateModelConfig:
         invalid_config = valid_dashboard_config.copy()
         invalid_config["titles"] = invalid_config.pop("title")
 
-        result = validate_model_config(config=invalid_config, data_infos=[iris_metadata], auto_open=False)
+        result = validate_model_config(dashboard_config=invalid_config, data_infos=[iris_metadata], auto_open=False)
 
         assert result.valid is False
         assert "Validation Error: 1 validation error for Dashboard" in result.message
@@ -256,7 +258,7 @@ class TestValidateChartCode:
         chart_plan_validation_result: ValidationResults,
     ) -> None:
         """Test successful validation of chart code."""
-        result = validate_chart_code(config=valid_chart_plan, data_info=iris_metadata, auto_open=False)
+        result = validate_chart_code(chart_config=valid_chart_plan, data_info=iris_metadata, auto_open=False)
 
         # Compare everything but the pycafe_url
         assert result.valid == chart_plan_validation_result.valid
@@ -274,7 +276,7 @@ class TestValidateChartCode:
         iris_metadata: DFMetaData,
     ) -> None:
         """Test validation error for an invalid chart plan."""
-        result = validate_chart_code(config=invalid_chart_plan, data_info=iris_metadata, auto_open=False)
+        result = validate_chart_code(chart_config=invalid_chart_plan, data_info=iris_metadata, auto_open=False)
 
         assert result.valid is False
         assert result.python_code == ""