@unovis/mcp 1.7.0-mcp.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/LICENSE +193 -0
  2. package/README.md +154 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +109 -0
  5. package/dist/cli.js.map +1 -0
  6. package/dist/codegen/index.d.ts +14 -0
  7. package/dist/codegen/index.js +346 -0
  8. package/dist/codegen/index.js.map +1 -0
  9. package/dist/env/bbox.d.ts +13 -0
  10. package/dist/env/bbox.js +335 -0
  11. package/dist/env/bbox.js.map +1 -0
  12. package/dist/env/canvas.d.ts +9 -0
  13. package/dist/env/canvas.js +55 -0
  14. package/dist/env/canvas.js.map +1 -0
  15. package/dist/env/computed-style.d.ts +38 -0
  16. package/dist/env/computed-style.js +186 -0
  17. package/dist/env/computed-style.js.map +1 -0
  18. package/dist/env/fonts.d.ts +3 -0
  19. package/dist/env/fonts.js +103 -0
  20. package/dist/env/fonts.js.map +1 -0
  21. package/dist/env/index.d.ts +13 -0
  22. package/dist/env/index.js +121 -0
  23. package/dist/env/index.js.map +1 -0
  24. package/dist/env/raf-queue.d.ts +23 -0
  25. package/dist/env/raf-queue.js +51 -0
  26. package/dist/env/raf-queue.js.map +1 -0
  27. package/dist/env/size.d.ts +9 -0
  28. package/dist/env/size.js +30 -0
  29. package/dist/env/size.js.map +1 -0
  30. package/dist/html/document.d.ts +16 -0
  31. package/dist/html/document.js +95 -0
  32. package/dist/html/document.js.map +1 -0
  33. package/dist/index.d.ts +25 -0
  34. package/dist/index.js +18 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/recipes/area.d.ts +66 -0
  37. package/dist/recipes/area.js +76 -0
  38. package/dist/recipes/area.js.map +1 -0
  39. package/dist/recipes/bar.d.ts +67 -0
  40. package/dist/recipes/bar.js +69 -0
  41. package/dist/recipes/bar.js.map +1 -0
  42. package/dist/recipes/boxplot.d.ts +64 -0
  43. package/dist/recipes/boxplot.js +89 -0
  44. package/dist/recipes/boxplot.js.map +1 -0
  45. package/dist/recipes/chord.d.ts +41 -0
  46. package/dist/recipes/chord.js +72 -0
  47. package/dist/recipes/chord.js.map +1 -0
  48. package/dist/recipes/choropleth-regions.d.ts +49 -0
  49. package/dist/recipes/choropleth-regions.js +521 -0
  50. package/dist/recipes/choropleth-regions.js.map +1 -0
  51. package/dist/recipes/choropleth.d.ts +27 -0
  52. package/dist/recipes/choropleth.js +86 -0
  53. package/dist/recipes/choropleth.js.map +1 -0
  54. package/dist/recipes/donut.d.ts +25 -0
  55. package/dist/recipes/donut.js +51 -0
  56. package/dist/recipes/donut.js.map +1 -0
  57. package/dist/recipes/graph.d.ts +55 -0
  58. package/dist/recipes/graph.js +132 -0
  59. package/dist/recipes/graph.js.map +1 -0
  60. package/dist/recipes/heatmap.d.ts +21 -0
  61. package/dist/recipes/heatmap.js +79 -0
  62. package/dist/recipes/heatmap.js.map +1 -0
  63. package/dist/recipes/index.d.ts +5 -0
  64. package/dist/recipes/index.js +35 -0
  65. package/dist/recipes/index.js.map +1 -0
  66. package/dist/recipes/line.d.ts +69 -0
  67. package/dist/recipes/line.js +64 -0
  68. package/dist/recipes/line.js.map +1 -0
  69. package/dist/recipes/nested-donut.d.ts +22 -0
  70. package/dist/recipes/nested-donut.js +47 -0
  71. package/dist/recipes/nested-donut.js.map +1 -0
  72. package/dist/recipes/radial-bar.d.ts +25 -0
  73. package/dist/recipes/radial-bar.js +53 -0
  74. package/dist/recipes/radial-bar.js.map +1 -0
  75. package/dist/recipes/sankey.d.ts +41 -0
  76. package/dist/recipes/sankey.js +61 -0
  77. package/dist/recipes/sankey.js.map +1 -0
  78. package/dist/recipes/scatter.d.ts +68 -0
  79. package/dist/recipes/scatter.js +75 -0
  80. package/dist/recipes/scatter.js.map +1 -0
  81. package/dist/recipes/shared.d.ts +144 -0
  82. package/dist/recipes/shared.js +212 -0
  83. package/dist/recipes/shared.js.map +1 -0
  84. package/dist/recipes/timeline.d.ts +31 -0
  85. package/dist/recipes/timeline.js +123 -0
  86. package/dist/recipes/timeline.js.map +1 -0
  87. package/dist/recipes/treemap.d.ts +19 -0
  88. package/dist/recipes/treemap.js +43 -0
  89. package/dist/recipes/treemap.js.map +1 -0
  90. package/dist/recipes/types.d.ts +16 -0
  91. package/dist/recipes/types.js +2 -0
  92. package/dist/recipes/types.js.map +1 -0
  93. package/dist/render/headless.d.ts +62 -0
  94. package/dist/render/headless.js +158 -0
  95. package/dist/render/headless.js.map +1 -0
  96. package/dist/render/materialize.d.ts +35 -0
  97. package/dist/render/materialize.js +160 -0
  98. package/dist/render/materialize.js.map +1 -0
  99. package/dist/render/mutex.d.ts +9 -0
  100. package/dist/render/mutex.js +14 -0
  101. package/dist/render/mutex.js.map +1 -0
  102. package/dist/render/rasterize.d.ts +10 -0
  103. package/dist/render/rasterize.js +29 -0
  104. package/dist/render/rasterize.js.map +1 -0
  105. package/dist/render/renderer.d.ts +21 -0
  106. package/dist/render/renderer.js +66 -0
  107. package/dist/render/renderer.js.map +1 -0
  108. package/dist/render/spec.d.ts +95 -0
  109. package/dist/render/spec.js +15 -0
  110. package/dist/render/spec.js.map +1 -0
  111. package/dist/server.d.ts +4 -0
  112. package/dist/server.js +44 -0
  113. package/dist/server.js.map +1 -0
  114. package/dist/svg/collect-css.d.ts +14 -0
  115. package/dist/svg/collect-css.js +53 -0
  116. package/dist/svg/collect-css.js.map +1 -0
  117. package/dist/svg/css-vars.d.ts +17 -0
  118. package/dist/svg/css-vars.js +64 -0
  119. package/dist/svg/css-vars.js.map +1 -0
  120. package/dist/svg/header.d.ts +8 -0
  121. package/dist/svg/header.js +81 -0
  122. package/dist/svg/header.js.map +1 -0
  123. package/dist/svg/ids.d.ts +12 -0
  124. package/dist/svg/ids.js +94 -0
  125. package/dist/svg/ids.js.map +1 -0
  126. package/dist/svg/postprocess.d.ts +41 -0
  127. package/dist/svg/postprocess.js +135 -0
  128. package/dist/svg/postprocess.js.map +1 -0
  129. package/dist/tools/register.d.ts +12 -0
  130. package/dist/tools/register.js +127 -0
  131. package/dist/tools/register.js.map +1 -0
  132. package/dist/widget/bundle.js +1777 -0
  133. package/dist/widget/bundle.meta.json +3 -0
  134. package/dist/widget/entry.d.ts +34 -0
  135. package/dist/widget/entry.js +118 -0
  136. package/dist/widget/entry.js.map +1 -0
  137. package/dist/widget/interactions.d.ts +14 -0
  138. package/dist/widget/interactions.js +151 -0
  139. package/dist/widget/interactions.js.map +1 -0
  140. package/dist/widget/unovis-slim.d.ts +33 -0
  141. package/dist/widget/unovis-slim.js +34 -0
  142. package/dist/widget/unovis-slim.js.map +1 -0
  143. package/docs/README.md +56 -0
  144. package/docs/architecture.md +158 -0
  145. package/docs/chart-spec.md +148 -0
  146. package/docs/getting-started.md +175 -0
  147. package/docs/interactive.md +125 -0
  148. package/docs/output-types.md +170 -0
  149. package/docs/programmatic.md +234 -0
  150. package/docs/tools.md +273 -0
  151. package/docs/troubleshooting.md +140 -0
  152. package/fonts/README.md +19 -0
  153. package/package.json +73 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postprocess.js","sourceRoot":"","sources":["../../src/svg/postprocess.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { AnyRecipe } from '../recipes/index.js';
3
+ export interface ToolFilterOptions {
4
+ /** Tool names to hide (env DISABLED_TOOLS / --disable-tools) */
5
+ disabledTools?: string[];
6
+ /** When set, only these tools are exposed (--tools) */
7
+ enabledTools?: string[];
8
+ }
9
+ /** MCP UI resource the interactive output binds to (registered in server.ts) */
10
+ export declare const WIDGET_URI = "ui://unovis/chart";
11
+ export declare function activeRecipes(filter?: ToolFilterOptions): AnyRecipe[];
12
+ export declare function registerTools(server: McpServer, filter?: ToolFilterOptions): void;
@@ -0,0 +1,127 @@
1
+ /** Bind chart recipes to MCP tools. */
2
+ import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { dirname, isAbsolute, join } from 'node:path';
5
+ import { recipes } from '../recipes/index.js';
6
+ import { renderChart, resolveMapMarkers, ChartInputError } from '../render/renderer.js';
7
+ import { svgToPng, themeBackground } from '../render/rasterize.js';
8
+ import { buildChartDocument } from '../html/document.js';
9
+ import { generateCode, formatGeneratedFiles } from '../codegen/index.js';
10
+ /** MCP UI resource the interactive output binds to (registered in server.ts) */
11
+ export const WIDGET_URI = 'ui://unovis/chart';
12
+ const textResult = (text, isError = false) => ({ content: [{ type: 'text', text }], ...(isError ? { isError: true } : {}) });
13
+ /** Map data lives behind a `{ $unovisMap }` marker that only the Node renderer
14
+ * resolves — the browser widget has no map bundles, so bake it into the spec */
15
+ async function specForBrowser(spec) {
16
+ return { ...spec, components: await resolveMapMarkers(spec.components) };
17
+ }
18
+ const chartSummary = (spec) => `${spec.title ?? spec.components.map(c => c.type).join(' + ')} (${spec.width}×${spec.height}, ${spec.theme} theme)`;
19
+ async function runRecipe(recipe, input) {
20
+ try {
21
+ const spec = recipe.toSpec(input);
22
+ if (input.outputType === 'config') {
23
+ return textResult(JSON.stringify(spec, null, 2));
24
+ }
25
+ // Code: emit source for the chosen wrapper. Uses the unresolved spec so
26
+ // map data stays an import rather than an inlined payload.
27
+ if (input.outputType === 'code') {
28
+ const files = generateCode(spec, input.framework ?? 'ts');
29
+ return textResult(formatGeneratedFiles(files));
30
+ }
31
+ // Interactive: hand the spec to a UI-capable client, which renders it with
32
+ // the widget resource. Static content stays in the transcript as a summary.
33
+ if (input.outputType === 'interactive') {
34
+ const browserSpec = await specForBrowser(spec);
35
+ return {
36
+ content: [{ type: 'text', text: `Interactive chart: ${chartSummary(spec)}` }],
37
+ structuredContent: { spec: browserSpec },
38
+ _meta: { 'openai/outputTemplate': WIDGET_URI },
39
+ };
40
+ }
41
+ const isHtml = input.outputType === 'html';
42
+ const isPng = input.outputType === 'png';
43
+ const extension = isHtml ? '.html' : isPng ? '.png' : '.svg';
44
+ const outputPath = input.outputPath;
45
+ if (outputPath && (!isAbsolute(outputPath) || !outputPath.endsWith(extension))) {
46
+ return textResult(`outputPath must be an absolute path ending in ${extension} (matching outputType), got: ${outputPath}`, true);
47
+ }
48
+ // Self-contained interactive document. Always written to disk: the inlined
49
+ // widget bundle is far too large to put in a tool result.
50
+ if (isHtml) {
51
+ const html = buildChartDocument(await specForBrowser(spec));
52
+ const target = outputPath ?? join(mkdtempSync(join(tmpdir(), 'unovis-chart-')), 'chart.html');
53
+ mkdirSync(dirname(target), { recursive: true });
54
+ writeFileSync(target, html);
55
+ return textResult(`Interactive chart saved to ${target} — open it in a browser for tooltips, ` +
56
+ `crosshair and hover highlighting. ${chartSummary(spec)}`);
57
+ }
58
+ const result = await renderChart(spec);
59
+ const warningsNote = result.warnings.length ? ` (warnings: ${result.warnings.join('; ')})` : '';
60
+ if (isPng) {
61
+ const png = await svgToPng(result.svg, {
62
+ width: result.width,
63
+ scale: input.scale ?? 2,
64
+ background: themeBackground(spec.theme),
65
+ });
66
+ if (outputPath) {
67
+ mkdirSync(dirname(outputPath), { recursive: true });
68
+ writeFileSync(outputPath, png);
69
+ return textResult(`Chart saved to ${outputPath} (${result.width}×${result.height} at ${input.scale ?? 2}x)${warningsNote}`);
70
+ }
71
+ return {
72
+ content: [
73
+ { type: 'image', data: png.toString('base64'), mimeType: 'image/png' },
74
+ ...(warningsNote ? [{ type: 'text', text: warningsNote.trim() }] : []),
75
+ ],
76
+ };
77
+ }
78
+ if (outputPath) {
79
+ mkdirSync(dirname(outputPath), { recursive: true });
80
+ writeFileSync(outputPath, `<?xml version="1.0" encoding="UTF-8"?>\n${result.svg}`);
81
+ return textResult(`Chart saved to ${outputPath} (${result.width}×${result.height})${warningsNote}`);
82
+ }
83
+ return textResult(result.svg + (result.warnings.length ? `\n<!-- warnings: ${result.warnings.join('; ')} -->` : ''));
84
+ }
85
+ catch (e) {
86
+ if (e instanceof ChartInputError) {
87
+ return textResult(`Invalid input for ${recipe.name}: ${e.message}`, true);
88
+ }
89
+ return textResult(`Failed to render ${recipe.name}: ${e instanceof Error ? e.message : String(e)}`, true);
90
+ }
91
+ }
92
+ export function activeRecipes(filter = {}) {
93
+ const disabled = new Set(filter.disabledTools ?? []);
94
+ const enabled = filter.enabledTools?.length ? new Set(filter.enabledTools) : undefined;
95
+ return recipes.filter(r => !disabled.has(r.name) && (!enabled || enabled.has(r.name)));
96
+ }
97
+ export function registerTools(server, filter = {}) {
98
+ for (const recipe of activeRecipes(filter)) {
99
+ server.registerTool(recipe.name, {
100
+ title: recipe.title,
101
+ description: recipe.description,
102
+ inputSchema: recipe.inputShape,
103
+ annotations: {
104
+ readOnlyHint: false, // outputPath can write a file
105
+ openWorldHint: false, // fully local, no network
106
+ },
107
+ },
108
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
109
+ async (args) => runRecipe(recipe, args));
110
+ }
111
+ server.registerTool('get_unovis_info', {
112
+ title: 'Unovis info',
113
+ description: 'Get information about this Unovis chart server: available chart tools, default color palette, themes and output modes.',
114
+ inputSchema: {},
115
+ annotations: { readOnlyHint: true, openWorldHint: false },
116
+ }, async () => textResult(JSON.stringify({
117
+ library: 'Unovis (https://unovis.dev)',
118
+ rendering: 'local headless SVG — no browser, no remote services',
119
+ tools: activeRecipes(filter).map(r => ({ name: r.name, title: r.title })),
120
+ themes: ['light', 'dark'],
121
+ outputTypes: ['svg', 'png', 'html', 'interactive', 'config', 'code'],
122
+ frameworks: ['ts', 'react', 'svelte', 'vue', 'angular', 'solid'],
123
+ interactive: 'html writes a self-contained interactive file; interactive renders inline in clients supporting MCP UI widgets',
124
+ defaultPalette: ['#4D8CFD', '#FF6B7E', '#F4B83E', '#A6CC74', '#00C19A', '#6859BE'],
125
+ }, null, 2)));
126
+ }
127
+ //# sourceMappingURL=register.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"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"}