Skip to main content
Glama
deenesjakoruzh
GongRzhe

Quickchart-MCP-Server

by GongRzhe
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

quickchart-server MCP-сервер

изображение

Сервер Model Context Protocol для создания диаграмм с использованием QuickChart.io

Это MCP-сервер на основе TypeScript, который предоставляет возможности генерации диаграмм. Он позволяет создавать различные типы диаграмм с помощью инструментов MCP.

Обзор

Этот сервер интегрируется с сервисом генерации диаграмм на основе URL QuickChart.io для создания изображений диаграмм с использованием конфигураций Chart.js. Пользователи могут создавать различные типы диаграмм, предоставляя данные и параметры стилей, которые сервер преобразует в URL диаграмм или загружаемые изображения.

Related MCP server: quickchart-mcp-server

Функции

Инструменты

  • generate_chart — создание URL-адреса диаграммы с помощью QuickChart.io

    • Поддерживает несколько типов диаграмм: столбчатая, линейная, круговая, кольцевая, радарная, полярная, точечная, пузырьковая, радиальная, спидометрическая.

    • Возможность настройки с помощью меток, наборов данных, цветов и дополнительных опций

    • Возвращает URL-адрес сгенерированной диаграммы.

  • download_chart — Загрузить изображение диаграммы в локальный файл

    • Принимает конфигурацию диаграммы и выходной путь в качестве параметров

    • Сохраняет изображение диаграммы в указанном месте. изображение

изображение

Поддерживаемые типы диаграмм

  • Гистограммы: для сравнения значений по категориям.

  • Линейные диаграммы: для отображения тенденций с течением времени.

  • Круговые диаграммы: для отображения пропорциональных данных.

  • Кольцевые диаграммы: похожи на круговые диаграммы с полым центром.

  • Радарные диаграммы: для отображения многомерных данных.

  • Полярные диаграммы: для отображения пропорциональных данных с фиксированными угловыми сегментами.

  • Диаграммы рассеяния: для отображения распределения точек данных.

  • Пузырьковые диаграммы: для трехмерной визуализации данных.

  • Радиальный датчик: для отображения отдельных значений в пределах диапазона.

  • Спидометр: для отображения показаний в стиле спидометра

Использование

Конфигурация диаграммы

Сервер использует формат конфигурации Chart.js. Вот простой пример:

{
  "type": "bar",
  "data": {
    "labels": ["January", "February", "March"],
    "datasets": [{
      "label": "Sales",
      "data": [65, 59, 80],
      "backgroundColor": "rgb(75, 192, 192)"
    }]
  },
  "options": {
    "title": {
      "display": true,
      "text": "Monthly Sales"
    }
  }
}

Генерация URL-адресов

Сервер преобразует вашу конфигурацию в URL-адрес QuickChart:

https://quickchart.io/chart?c={...encoded configuration...}

Разработка

Установить зависимости:

npm install

Сборка сервера:

npm run build

Установка

Установка

npm install @gongrzhe/quickchart-mcp-server

Установка через Smithery

Чтобы автоматически установить QuickChart Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @gongrzhe/quickchart-mcp-server --client claude

Для использования с Claude Desktop добавьте конфигурацию сервера:

В MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json В Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "quickchart-server": {
      "command": "node",
      "args": ["/path/to/quickchart-server/build/index.js"]
    }
  }
}

или

{
  "mcpServers": {
    "quickchart-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gongrzhe/quickchart-mcp-server"
      ]
    }
  }
}

Ссылки на документацию

📜 Лицензия

Данный проект лицензирован по лицензии MIT.

Available Tools

2 tools
download_chartC

Download a chart image to a local file

ParametersJSON Schema
NameRequiredDescriptionDefault
configYesChart configuration object
outputPathNoPath where the chart image should be saved. If not provided, the chart will be saved to Desktop or home directory.

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but provides minimal behavioral information. It mentions saving to Desktop/home directory as a fallback, which is useful, but doesn't disclose important traits like file format, permissions needed, whether it overwrites existing files, error conditions, or what happens if the config is invalid.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise - a single sentence that communicates the core functionality without any wasted words. It's front-loaded with the essential information and doesn't include unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no annotations, no output schema, and a nested object parameter (config), the description is insufficient. It doesn't explain what the chart configuration should contain, what image formats are supported, what happens on success/failure, or provide any context about the relationship with the sibling 'generate_chart' tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the baseline is 3. The description doesn't add any parameter information beyond what's already in the schema - it doesn't explain what a 'chart configuration object' should contain, provide examples, or clarify the outputPath behavior beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Download') and the resource ('a chart image to a local file'), making the purpose immediately understandable. However, it doesn't distinguish this tool from its sibling 'generate_chart' - it's unclear if 'download_chart' generates and downloads or just downloads an existing chart.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. The description doesn't mention the sibling tool 'generate_chart' or explain the relationship between generating and downloading charts, leaving the agent to guess about appropriate usage contexts.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_chartC

Generate a chart using QuickChart

ParametersJSON Schema
NameRequiredDescriptionDefault
typeYesChart type (bar, line, pie, doughnut, radar, polarArea, scatter, bubble, radialGauge, speedometer)
labelsNoLabels for data points
datasetsYes
titleNo
optionsNo

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but provides minimal information. It mentions 'using QuickChart' which hints at an external service dependency, but doesn't describe what the tool actually returns (e.g., URL, image data, error handling), rate limits, authentication needs, or whether it's a read-only or mutating operation. For a tool with complex parameters and no annotations, this is inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise at just 4 words, with zero wasted language. It's front-loaded with the core functionality and uses minimal space to convey the basic purpose. Every word earns its place in this brief description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 5 parameters (including complex nested objects), no annotations, no output schema, and a sibling tool, the description is severely incomplete. It doesn't explain what the tool returns, how to interpret results, error conditions, or how it differs from the sibling 'download_chart' tool. The minimal description leaves too many gaps for effective agent usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With only 40% schema description coverage, the description doesn't compensate by explaining any of the 5 parameters. The schema provides some parameter descriptions (like 'labels for data points' and 'chart type'), but the description adds no additional semantic context about what parameters mean, how they interact, or what values are expected beyond what's in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('generate') and resource ('chart using QuickChart'), making the purpose immediately understandable. However, it doesn't differentiate from the sibling 'download_chart' tool, which appears to be a related but distinct operation. The description is specific about what the tool does but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus the sibling 'download_chart' tool, nor does it mention any prerequisites, constraints, or alternative approaches. There's no indication of when this tool is appropriate versus other chart generation methods or the sibling tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • First observeddownload_chart
    • First observedgenerate_chart
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.9/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: 'download_chart' focuses on saving a chart image to a file, while 'generate_chart' focuses on creating the chart itself. There is no overlap or ambiguity between these operations.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern ('download_chart' and 'generate_chart'), using snake_case and clear action verbs. This makes them predictable and easy to understand.

Tool Count2/5

With only two tools, the server feels under-scoped for a chart generation domain. It lacks essential operations like updating, deleting, or listing charts, which limits its utility and completeness.

Completeness2/5

The tool set is severely incomplete for chart generation. It covers creation and downloading but misses critical operations such as updating chart data, deleting charts, or retrieving existing charts, leaving significant gaps in the workflow.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches