Skip to main content

Vizro-MCP

Vizro-MCP is a Model Context Protocol (MCP) server, which works alongside an LLM to help you create Vizro dashboards and charts.

Vizro-MCP Demo

To find out more, consult the Vizro-MCP documentation.

Set up Vizro-MCP

Vizro-MCP is best used with Claude Desktop, Cursor or VS Code. However, it can be used with most LLM products that enable configuration of MCP server usage.

💡 Tip: For best performance, we recommend using the claude-4-sonnet model, or another high-performing model of your choice. Using the often offered auto setting may lead to inconsistent or unexpected results.

Our documentation offers separate, detailed steps for Claude Desktop, Cursor and VS Code.

Basic configuration

The following is for those familiar with MCP server setup who are comfortable with basic configuration settings. You must have downloaded and installed the LLM app you want to configure and use as a MCP host.

Quick setup for Vizro-MCP using uv

You must first install uv.

Next, open a terminal window and type uv to confirm that is available. To get the path to uvx, type the following:

which uv

Copy the path returned, and add the following to the JSON file used to configure MCP servers for your LLM app. Be sure to substitute your path to uv as returned above, for the placeholder given:

{
  "mcpServers": {
    "vizro-mcp": {
      "command": "/placeholder-path/uvx",
      "args": [
        "vizro-mcp"
      ]
    }
  }
}

Quick install

Host Prerequisite Link
Cursor uv Install with UVX in Cursor
VS Code uv Install with UVX in VS Code
Quick setup for Vizro-MCP using Docker

You must first install Docker.

Next, add the following to the JSON file used to configure MCP servers for your LLM app.

{
  "mcpServers": {
    "vizro-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/vizro"
      ]
    }
  }
}

To use local data with Docker

Mount your data directory or directories into the container with the following extended configuration. Replace </absolute/path/to/allowed/dir> (syntax for folders) or </absolute/path/to/data.csv> (syntax for files) with the absolute path to your data on your machine. For consistency, we recommend that the dst path matches the src path.

{
  "mcpServers": {
    "vizro-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount",
        "type=bind,src=</absolute/path/to/allowed/dir>,dst=</absolute/path/to/allowed/dir>",
        "--mount",
        "type=bind,src=</absolute/path/to/data.csv>,dst=</absolute/path/to/data.csv>",
        "mcp/vizro"
      ]
    }
  }
}

Quick install

Host Prerequisite Link Notes
Cursor Docker Install with Docker in Cursor For local data access, mount your data directory
VS Code Docker Install with Docker in VS Code For local data access, mount your data directory

Disclaimers

Transparency and trust

MCP servers are a relatively new concept, and it is important to be transparent about what the tools are capable of so you can make an informed choice as a user. Overall, the Vizro MCP server only reads data, and never writes, deletes or modifies any data on your machine.

Third party API

Users are responsible for anything done via their host LLM application.

Users are responsible for procuring any and all rights necessary to access any third-party generative AI tools and for complying with any applicable terms or conditions thereof.

Users are wholly responsible for the use and security of the third-party generative AI tools and of Vizro.

User acknowledgments

Users acknowledge and agree that:

Any results, options, data, recommendations, analyses, code, or other information (“Outputs”) generated by any third-party generative AI tools (“GenAI Tools”) may contain some inaccuracies, biases, illegitimate, potentially infringing, or otherwise inappropriate content that may be mistaken, discriminatory, or misleading.

McKinsey & Company:

(i) expressly disclaims the accuracy, adequacy, timeliness, reliability, merchantability, fitness for a particular purpose, non-infringement, safety or completeness of any Outputs,

(ii) shall not be liable for any errors, omissions, or other defects in, delays or interruptions in such Outputs, or for any actions taken in reliance thereon, and

(iii) shall not be liable for any alleged violation or infringement of any right of any third party resulting from the users’ use of the GenAI Tools and the Outputs.

The Outputs shall be verified and validated by the users and shall not be used without human oversight and as a sole basis for making decisions impacting individuals.

Users remain solely responsible for the use of the Output, in particular, the users will need to determine the level of human oversight needed to be given the context and use case, as well as for informing the users’ personnel and other affected users about the nature of the GenAI Output. Users are also fully responsible for their decisions, actions, use of Vizro and Vizro-MCP and compliance with applicable laws, rules, and regulations, including but not limited to confirming that the Outputs do not infringe any third-party rights.

Warning and safety usage for generative AI models

Vizro-MCP is used by generative AI models because large language models (LLMs) represent significant advancements in the AI field. However, as with any powerful tool, there are potential risks associated with connecting to a generative AI model.

We recommend users research and understand the selected model before using Vizro-MCP. We also recommend users to check the MCP server code before using it.

Users are encouraged to treat AI-generated content as supplementary, always apply human judgment, approach with caution, review the relevant disclaimer page, and consider the following:

  1. Hallucination and misrepresentation
  2. Generative models can potentially generate information while appearing factual, being entirely fictitious or misleading.

    The vendor models might lack real-time knowledge or events beyond its last updates. Vizro-MCP output may vary and you should always verify critical information. It is the user's responsibility to discern the accuracy, consistent, and reliability of the generated content.

  3. Unintended and sensitive output
  4. The outputs from these models can be unexpected, inappropriate, or even harmful. Users as human in the loop is an essential part. Users must check and interpret the final output. It is necessary to approach the generated content with caution, especially when shared or applied in various contexts.
  5. Data privacy
  6. Your data is sent to model vendors if you connect to LLMs via their APIs. For example, if you connect to the model from OpenAI, your data will be sent to OpenAI via their API. Users should be cautious about sharing or inputting any personal or sensitive information.
  7. Bias and fairness
  8. Generative AI can exhibit biases present in their training data. Users need to be aware of and navigate potential biases in generated outputs and be cautious when interpreting the generated content.
  9. Malicious use
  10. These models can be exploited for various malicious activities. Users should be cautious about how and where they deploy and access such models.
It's crucial for users to remain informed, cautious, and ethical in their applications.

Metadata

Release files for iflow-mcp_vizro-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_vizro-mcp 0.1.2
File Size Uploaded
iflow_mcp_vizro_mcp-0.1.2.tar.gz 6.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_vizro-mcp 0.1.2
File Interpreter ABI Platform
iflow_mcp_vizro_mcp-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 7.0 MB

Release files / iflow_mcp_vizro_mcp-0.1.2.tar.gz

Download URL iflow_mcp_vizro_mcp-0.1.2.tar.gz
Size 6.9 MB
Tags Source
SHA-256 checksum
How to use checksums
a756ab7afdd0e258b3cc13326287a6d6f6dac6a36e783be4692b4794343b2650
BLAKE2b-256 checksum
How to use checksums
7dba3543638ed48f92080e55c8e5ec0bf30e883e3d342eb0836c18d038236547
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release files / iflow_mcp_vizro_mcp-0.1.2-py3-none-any.whl

Download URL iflow_mcp_vizro_mcp-0.1.2-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
894946d6597404c1f94d792493d0c6b4d072377b3819010826f0b3563c0a94d4
BLAKE2b-256 checksum
How to use checksums
ff6cd6c46eec57670eaa9984a6e773ca777a54d3ce13d1358d6405df3d2288b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page