Что он умеет?

Сервер рисует графики по структурированным данным и умеет отдавать результат в SVG, PNG, HTML или data-URL. Он строит 14 типов диаграмм: от столбчатых и линейных до пузырьковых и полярных. Через отдельный инструмент сервер принимает сырой CSV, сам находит числовые колонки и сразу строит график. Ещё он перечисляет доступные типы диаграмм с описаниями и все темы оформления и цветовые палитры.

Каталог MCP
marzukia/charted

marzukia/charted

от marzukia

MCP сервер charted - лёгкий инструмент для создания 15 типов графиков (SVG/PNG) без внешних зависимостей. Запускается одной командой, идеален для AI-агентов и Python-проектов, готов к интеграции с ...

Github PyPi Сайт сервера

README

4 инструмента

Версии

Установить сервер

Zero-dependency charts for Python and AI agents. SVG and PNG, 15 chart types, a one-line MCP server, and a Claude skill.

Quickstart

uv add charted

Or with pip:

pip install charted

from charted import BarChart

chart = BarChart(
    title="Sales by Quarter",
    data=[120, 180, 210, 150],
    labels=["Q1", "Q2", "Q3", "Q4"],
)
chart.save("chart.svg")
chart.save("chart.png")  # PNG export (requires cairosvg)

That is the whole loop: pass a list of numbers, get back an image. No numpy, no pandas, no config files.

Core principle: charted itself has zero runtime dependencies. PNG export and MCP server support are opt-in extras that pull in their own dependencies, and the base library stays pure Python.

Gallery

Every chart type, rendered. Each image below was generated by charted itself from the example script; the Quick Tour shows the code behind each one.


Bar	Column	Line
Scatter	Pie	Area
Radar	Box Plot	Histogram
Heatmap	Gantt	Bubble
Combo	Polar Area

Часто задаваемые вопросы

Инструменты были проиндексированы: 21.10.2026

chart_from_csv

Парсит сырой CSV-текст и создаёт диаграмму напрямую из него, без необходимости предварительной обработки данных. Инструмент автоматически определяет числовые столбцы для оси Y и использует первый нечисловой столбец в качестве меток оси X. Используйте это, когда пользователь предоставляет CSV-содержимое напрямую; для данных, уже находящихся в Python списке или словаре, используйте create_chart.

Параметры

chart_typeenum
csv_datastringобязательный
output_formatenum
Формат возвращаемой диаграммы: 'svg' (по умолчанию), 'html', 'data_url' (SVG data URL) или 'png' (растеризованное изображение, требует charted[png]).
save_pathstring
Необязательный путь к файлу для сохранения диаграммы на диск. Расширение должно соответствовать output_format, например 'output/chart.svg'. Инструмент по-прежнему возвращает содержимое диаграммы в ответе.
scalenumber
Множитель разрешения для вывода в формате 'png'. По умолчанию равен 2, что обеспечивает вывод для дисплеев с высоким DPI. На форматы SVG не влияет.
themestring | object
Визуальная тема. Передайте имя пресета ('light', 'dark', 'high-contrast') или имя палитры ('viridis', 'inferno' и т.д.) строкой, либо объект конфигурации. Чтобы посмотреть все варианты, используйте list_themes.
titlestring
Необязательный заголовок диаграммы, отображаемый над областью графика. Пример: «Продажи за первый квартал по регионам».
x_columnstring
Название столбца CSV для использования в качестве подписей категорий на оси X. Если не указано, автоматически используется первый нечисловой столбец. Пример: 'Month'.
y_columnsstring[]
Названия столбцов CSV для построения в качестве рядов данных. Если не указано, используются все числовые столбцы (кроме x_column). Пример: ['Revenue', 'Costs'].

create_chart

Генерирует SVG, HTML, data-URL или растровый PNG-график из структурированных данных. Поддерживает 14 типов графиков (bar, column, line, scatter, bubble, pie, polar_area, radar, area, box, histogram, heatmap, gantt, combo) плюс 'auto', который автоматически выбирает лучший тип. Используйте это, когда у вас уже есть данные в памяти в виде списка или словаря; для CSV-ввода предпочтительнее использовать chart_from_csv.

Параметры

chart_typeenumобязательный
Тип диаграммы для отображения. Режим 'auto' анализирует структуру данных и выбирает наиболее подходящий тип. Примеры: 'bar' для горизонтального сравнения категорий, 'line' для временных рядов, 'pie' для долей от целого, 'scatter' для корреляции XY, 'heatmap' для двумерной цветовой матрицы.
dataarray | objectобязательный
Данные для графика. Для одного ряда передайте одномерный список чисел, например [10, 20, 15]. Для нескольких рядов передайте двумерный список, где каждый внутренний список — это один ряд, например [[10, 20], [5, 30]]. Точечные и пузырьковые графики ожидают [[x_values], [y_values]].
heightnumber
Высота холста графика в пикселях. По умолчанию - 500. Настройте для управления соотношением сторон.
labelsstring[]
Метки категорий для оси X, по одной на каждую точку данных. Пример: ['Jan', 'Feb', 'Mar']. Опускайте для числовых или автоматически индексируемых осей.
output_formatenum
Формат для возвращаемого графика. 'svg' возвращает исходную SVG-разметку (по умолчанию, без лишних зависимостей). 'html' оборачивает SVG в минимальную HTML-страницу. 'data_url' возвращает SVG data URL, подходящий для использования в атрибуте src тега img. 'png' растеризует график в PNG-изображение (требуется charted[png]) и возвращает его как встроенное изображение, видимое в интерфейсах чатов.
save_pathstring
Необязательный абсолютный или относительный путь к файлу, куда нужно сохранить диаграмму на диске. Расширение файла должно совпадать с output_format (например, 'chart.svg' или 'chart.png'). В любом случае инструмент возвращает содержимое диаграммы.
scalenumber
Множитель разрешения применяется, когда output_format имеет значение 'png'. Значение 2 (по умолчанию) удваивает размеры в пикселях для дисплеев с высокой плотностью пикселей. Не влияет на вывод в формате SVG.
series_namesstring[]
Отображаемые имена для каждого ряда данных, показанные в легенде диаграммы. Должны соответствовать количеству рядов в данных. Пример: ['Выручка', 'Затраты'].
themestring | object
Визуальная тема. Передайте имя предустановки ('light', 'dark', 'high-contrast') или имя палитры ('viridis', 'inferno', 'ocean' и т.д.) в виде строки, либо объект конфигурации, например {'colors': 'viridis', 'background_color': '#1a1a2e'}. Используйте list_themes, чтобы увидеть все доступные варианты.
titlestring
Необязательный заголовок диаграммы, отображаемый над областью графика. Пример: 'Monthly Revenue 2024'.
widthnumber
Ширина холста диаграммы в пикселях. По умолчанию — 500. Увеличивайте для более детального отображения или более широких подписей.

list_chart_types

Верни полный список типов диаграмм, поддерживаемых charted, с указанием идентификатора каждого типа и краткого описания, для каких задач он лучше всего подходит. Вызывай это перед create_chart или chart_from_csv, если не уверен, какой chart_type выбрать.

Параметры

Без параметров.

list_themes

Возвращает все доступные пресеты тем и именованные цветовые палитры, которые можно передать в параметр theme функций create_chart или chart_from_csv. Также возвращает подсказку по использованию, показывающую, как объединить палитру с пользовательскими цветами фона и переднего плана.

Параметры

Без параметров.

`1.2.1`основная	18.06.2026
`1.2.0`	17.06.2026
`1.1.1`	05.06.2026
`1.1.0`	04.06.2026
`1.0.3`	25.05.2026
`0.1.8a0`	01.07.2024
`0.1.8`	01.07.2024
`0.1.7`	29.06.2024
`0.1.6`	25.06.2024
`0.1.5`	18.06.2024
`0.1.4`	15.06.2024
`0.1.3`	14.06.2024
`0.1.2`	13.06.2024
`0.1.1`	07.06.2024
`0.1.0`	21.05.2024

Выберите клиент, чтобы установить marzukia/charted:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "marzukia-charted-ojqtb4gg03": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"marzukia-charted-ojqtb4gg03\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"charted[mcp]\",\"charted-mcp\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add marzukia-charted-ojqtb4gg03 -- uvx --from charted[mcp] charted-mcp

Либо через JSON-конфиг:

claude mcp add-json marzukia-charted-ojqtb4gg03 "{\"command\":\"uvx\",\"args\":[\"--from\",\"charted[mcp]\",\"charted-mcp\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add marzukia-charted-ojqtb4gg03 -- uvx --from charted[mcp] charted-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.marzukia-charted-ojqtb4gg03]
command = "uvx"
args = ["--from", "charted[mcp]", "charted-mcp"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите marzukia/charted, а в поле команды запуска — строку ниже:

uvx --from charted[mcp] charted-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например marzukia-charted-ojqtb4gg03.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: marzukia-charted-ojqtb4gg03
    command: uvx
    args:
      - "--from"
      - "charted[mcp]"
      - "charted-mcp"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "marzukia-charted-ojqtb4gg03": {
      "command": "uvx",
      "args": [
        "--from",
        "charted[mcp]",
        "charted-mcp"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "--from",
    "charted[mcp]",
    "charted-mcp"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #196
Звезд на Github: 15
Форков на Github: 0
Загрузок: 3 693
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 21.10 в 05:33
Идентификатор: f8s7udvr0wFk8iAa
Категории: Визуализация данных

marzukia/charted

Quickstart

Gallery

Часто задаваемые вопросы

Похожие MCP-сервера

Ratnaditya-J/csvglow

hustcc/mcp-echarts

antv/mcp-server-chart

nteract/semiotic

isaacwasserman/mcp-vegalite-server

abhiphile/fermat-mcp