返回 MCP 目录
public公开dns本地运行

mcp-vegalite-server

一个基于MCP协议的数据可视化服务,支持Vega-Lite语法图表生成

article

README

🚀 模型上下文协议(MCP)服务器

本项目是一个模型上下文协议(MCP)服务器的实现,为大型语言模型提供接口,使其能够运用Vega - Lite语法对数据进行可视化,极大地增强了数据展示的灵活性和直观性。

🚀 快速开始

使用Claude Desktop

你可以按照以下示例代码将服务器添加到你的claude_desktop_config.json中:

# 将服务器添加到你的claude_desktop_config.json
{
  "mcpServers": {
    "datavis": {
        "command": "uv",
        "args": [
            "--directory",
            "/absolute/path/to/mcp-datavis-server",
            "run",
            "mcp_server_datavis",
            "--output_type",
            "png" # 或 "text"
        ]
    }
  }
}

✨ 主要特性

该服务器提供了两个核心工具,为数据的保存和可视化提供了便利:

save_data

  • 功能:将一张包含聚合数据的数据表保存到服务器,方便后续进行可视化操作。
  • 输入参数
    • name (字符串):数据表格的名称,用于标识该数据表。
    • data (数组):表示数据表格的对象数组,包含具体的数据内容。
  • 返回结果:操作成功后返回成功消息。

visualize_data

  • 功能:使用Vega - Lite语法对已保存的数据进行可视化。
  • 输入参数
    • data_name (字符串):要可视化的数据表格的名称,指定需要进行可视化操作的数据表。
    • vegalite_specification (字符串):表示Vega - Lite规范的JSON字符串,定义了可视化的具体样式和规则。
  • 返回结果
    • --output_type设为text,则返回一条包含额外artifact键的成功消息,其中包含完整的带数据的Vega - Lite规范。
    • --output_type设为png,则返回一个使用MPC ImageContent容器的base64编码的PNG图像。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端