@microcharts/mcp 0.1.0

package/dist/server-C0ga2mbD.mjs

@@ -0,0 +1,167 @@
+import { c as catalog, i as findChart, n as AGENT_SETUP, o as LIBRARY_VERSION, r as getChart, t as renderChart } from "./render-core-CnQfk-v1.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+//#region src/version.ts
+const MCP_VERSION = "0.1.0";
+//#endregion
+//#region src/server.ts
+/**
+* Output schemas. Declaring these is what lets a client type-check and validate
+* `structuredContent` instead of re-parsing the text block — the SDK checks
+* every result against them, so a drift between a tool's return type and what
+* it advertises fails here rather than in a host.
+*/
+const chartProp = z.object({
+	name: z.string(),
+	type: z.string(),
+	required: z.boolean(),
+	description: z.string(),
+	interactive: z.boolean().optional()
+});
+const findOutput = { results: z.array(z.object({
+	slug: z.string(),
+	name: z.string(),
+	tagline: z.string(),
+	dataShape: z.string(),
+	why: z.string().describe("The bestFor phrase or tagline that matched.")
+})) };
+const getOutput = {
+	slug: z.string(),
+	name: z.string(),
+	tagline: z.string(),
+	status: z.enum(["stable", "planned"]),
+	dataShape: z.string(),
+	encoding: z.object({
+		channel: z.string(),
+		precision: z.string()
+	}),
+	staticImport: z.string(),
+	interactiveImport: z.string().optional(),
+	bestFor: z.array(z.string()),
+	avoidFor: z.array(z.string()),
+	props: z.array(chartProp),
+	sharedProps: z.array(chartProp),
+	example: z.object({
+		title: z.string(),
+		code: z.string()
+	}),
+	sample: z.record(z.string(), z.unknown()).optional().describe("Ready-to-render props — pass straight to render_microchart.")
+};
+const renderOutput = {
+	svg: z.string(),
+	mimeType: z.enum(["image/svg+xml", "text/html"]),
+	summary: z.string().describe("The chart's generated accessible name — its alt text."),
+	width: z.number(),
+	height: z.number(),
+	library: z.string()
+};
+/**
+* Build the microcharts MCP server: three tools (find / get / render) + two
+* resources (the catalog, the agent-setup prompt). Transport-agnostic — `cli.ts`
+* wires it to stdio; a remote host could wire the same server to Streamable HTTP
+* without changing anything here.
+*/
+function createServer() {
+	const server = new McpServer({
+		name: "microcharts",
+		version: MCP_VERSION
+	}, { instructions: `microcharts renders word-sized charts. Use find_microchart to pick a chart for a question, get_microchart to see its props and a runnable example, and render_microchart to get a finished SVG with alt text. This server snapshots @microcharts/react ${LIBRARY_VERSION}.` });
+	server.registerTool("find_microchart", {
+		title: "Find a chart by question",
+		description: "Rank microcharts chart types against a plain-language question about data (\"is it trending?\", \"error budget\", \"part to whole\"). Returns candidates with the reason each matched. Start here when you know the question, not the chart.",
+		inputSchema: {
+			question: z.string().describe("What the data needs to show, in plain language."),
+			dataShape: z.string().optional().describe("Optional filter, e.g. \"number[]\"."),
+			limit: z.number().int().min(1).max(20).optional().describe("Max results (default 6).")
+		},
+		outputSchema: findOutput
+	}, ({ question, dataShape, limit }) => {
+		const results = findChart(question, {
+			...dataShape ? { dataShape } : {},
+			...limit ? { limit } : {}
+		});
+		return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(results, null, 2)
+			}],
+			structuredContent: { results }
+		};
+	});
+	server.registerTool("get_microchart", {
+		title: "Get a chart's props + example",
+		description: "Full wiring detail for one chart by slug: import paths, its props plus the shared props, data shape, best/avoid guidance, a copy-runnable example, and `sample` — the example as JSON props you can pass straight to render_microchart.",
+		inputSchema: { slug: z.string().describe("Chart slug, e.g. \"sparkline\".") },
+		outputSchema: getOutput
+	}, ({ slug }) => {
+		const result = getChart(slug);
+		if (!result) return {
+			content: [{
+				type: "text",
+				text: `Unknown chart "${slug}".`
+			}],
+			isError: true
+		};
+		return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 2)
+			}],
+			structuredContent: result
+		};
+	});
+	server.registerTool("render_microchart", {
+		title: "Render a chart to SVG",
+		description: "Render a chart to a finished, self-contained SVG (styles embedded) plus its generated alt text — for surfaces that can't run React. Pass the series as `data`; put other props (value, target, curve, color, width) in `props`. Each chart takes its own data shape — get_microchart returns a valid `sample` to adapt.",
+		inputSchema: {
+			type: z.string().describe("Chart slug, e.g. \"sparkline\"."),
+			data: z.any().optional().describe("Primary series; omit for scalar charts."),
+			props: z.record(z.string(), z.any()).optional().describe("Other props (value, target, color, …)."),
+			format: z.enum(["svg", "bare"]).optional().describe("`svg` (default) or `bare`.")
+		},
+		outputSchema: renderOutput
+	}, async (input) => {
+		try {
+			const result = await renderChart(input);
+			return {
+				content: [{
+					type: "text",
+					text: result.svg
+				}, {
+					type: "text",
+					text: `${result.summary} (${result.mimeType}, ${result.width}×${result.height})`
+				}],
+				structuredContent: result
+			};
+		} catch (err) {
+			return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
+		}
+	});
+	server.registerResource("catalog", "microcharts://catalog", {
+		title: "microcharts catalog",
+		description: "Every chart type with metadata, props, and the library version stamp.",
+		mimeType: "application/json"
+	}, (uri) => ({ contents: [{
+		uri: uri.href,
+		mimeType: "application/json",
+		text: JSON.stringify(catalog)
+	}] }));
+	server.registerResource("agent-setup", "microcharts://agent-setup", {
+		title: "microcharts agent setup",
+		description: "The canonical prompt for wiring microcharts into a codebase.",
+		mimeType: "text/markdown"
+	}, (uri) => ({ contents: [{
+		uri: uri.href,
+		mimeType: "text/markdown",
+		text: AGENT_SETUP
+	}] }));
+	return server;
+}
+//#endregion
+export { MCP_VERSION as n, createServer as t };

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@microcharts/mcp",
+  "version": "0.1.0",
+  "description": "MCP server + Vercel AI-SDK tools for microcharts — let a model find, wire, and render word-sized charts.",
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "charts",
+    "llm",
+    "mcp",
+    "microcharts",
+    "model-context-protocol",
+    "sparkline",
+    "svg"
+  ],
+  "homepage": "https://microcharts.dev/docs/mcp",
+  "license": "MIT",
+  "author": "Ganapati V S",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ganapativs/microcharts.git",
+    "directory": "packages/mcp"
+  },
+  "bin": {
+    "microcharts-mcp": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./ai-sdk": {
+      "types": "./dist/ai-sdk.d.mts",
+      "default": "./dist/ai-sdk.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "zod": "^3.25.76 || ^4.0.0",
+    "@microcharts/react": "^0.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "ai": "^7.0.37",
+    "esbuild": "^0.28.1",
+    "tsdown": "^0.22.14",
+    "tsx": "^4.23.1",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "ai": "^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "mcpName": "io.github.ganapativs/microcharts",
+  "scripts": {
+    "gen": "tsx scripts/gen.ts",
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}