@standby/mcp-server-chart 0.9.10

package/build/utils/env.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDisabledTools = getDisabledTools;
+exports.getChartImageDir = getChartImageDir;
+exports.getImageServerPort = getImageServerPort;
+const node_process_1 = __importDefault(require("node:process"));
+/**
+ * Get the list of disabled tools from environment variables.
+ */
+function getDisabledTools() {
+    const disabledTools = node_process_1.default.env.DISABLED_TOOLS;
+    if (!disabledTools || disabledTools === "undefined") {
+        return [];
+    }
+    return disabledTools.split(",");
+}
+/**
+ * Get the custom output directory for chart images, if set.
+ */
+function getChartImageDir() {
+    return node_process_1.default.env.CHART_IMAGE_DIR;
+}
+/**
+ * Get the port for the local image server.
+ */
+function getImageServerPort() {
+    const raw = node_process_1.default.env.IMAGE_SERVER_PORT;
+    if (!raw)
+        return 18900;
+    const port = Number.parseInt(raw, 10);
+    if (Number.isNaN(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid IMAGE_SERVER_PORT '${raw}': must be a number between 1 and 65535.`);
+    }
+    return port;
+}

package/build/utils/generate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate a chart URL by rendering locally with @antv/g2-ssr.
+ */
+export declare function generateChartUrl(type: string, options: Record<string, any>): Promise<string>;

package/build/utils/generate.js

@@ -0,0 +1,35 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateChartUrl = generateChartUrl;
+const image_server_1 = require("./image-server.js");
+const local_render_1 = require("./local-render.js");
+const logger_1 = require("./logger.js");
+const spec_translator_1 = require("./spec-translator.js");
+/**
+ * Generate a chart URL by rendering locally with @antv/g2-ssr.
+ */
+function generateChartUrl(type, 
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const g2Spec = (0, spec_translator_1.translateToG2Spec)(type, options);
+        if (!g2Spec) {
+            throw new Error(`Unsupported chart type for local rendering: '${type}'`);
+        }
+        const width = options.width || 600;
+        const height = options.height || 400;
+        const filePath = yield (0, local_render_1.renderG2SpecToFile)(g2Spec, width, height);
+        const url = (0, image_server_1.filePathToUrl)(filePath);
+        logger_1.logger.info(`Generated chart URL: ${url}`);
+        return url;
+    });
+}

package/build/utils/image-server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Start a local HTTP server to serve rendered chart images.
+ * Only starts once; subsequent calls resolve immediately.
+ * Returns a promise that resolves when the server is listening.
+ */
+export declare function startImageServer(host?: string, port?: number): Promise<void>;
+/**
+ * Get the URL prefix for served chart images.
+ */
+export declare function getImageUrlPrefix(): string;
+/**
+ * Convert a local file path to a URL served by the image server.
+ */
+export declare function filePathToUrl(filePath: string): string;
+/**
+ * Check if the image server has been started.
+ */
+export declare function isImageServerRunning(): boolean;

package/build/utils/image-server.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startImageServer = startImageServer;
+exports.getImageUrlPrefix = getImageUrlPrefix;
+exports.filePathToUrl = filePathToUrl;
+exports.isImageServerRunning = isImageServerRunning;
+const node_path_1 = __importDefault(require("node:path"));
+const express_1 = __importDefault(require("express"));
+const local_render_1 = require("./local-render.js");
+const logger_1 = require("./logger.js");
+let imageServerStarted = false;
+let imageServerPort = 18900;
+let imageServerHost = "localhost";
+/**
+ * Start a local HTTP server to serve rendered chart images.
+ * Only starts once; subsequent calls resolve immediately.
+ * Returns a promise that resolves when the server is listening.
+ */
+function startImageServer(host = "localhost", port = 18900) {
+    if (imageServerStarted)
+        return Promise.resolve();
+    imageServerHost = host;
+    imageServerPort = port;
+    return new Promise((resolve, reject) => {
+        const app = (0, express_1.default)();
+        const dir = (0, local_render_1.getOutputDir)();
+        app.use("/charts", express_1.default.static(dir));
+        const server = app.listen(port, host);
+        server.on("listening", () => {
+            imageServerStarted = true;
+            logger_1.logger.info(`Image server listening on http://${host}:${port}/charts`);
+            resolve();
+        });
+        server.on("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                logger_1.logger.error(`Image server port ${port} is already in use. Set IMAGE_SERVER_PORT to a different port.`);
+            }
+            else {
+                logger_1.logger.error(`Image server failed to start: ${err.message}`, err);
+            }
+            reject(err);
+        });
+    });
+}
+/**
+ * Get the URL prefix for served chart images.
+ */
+function getImageUrlPrefix() {
+    return `http://${imageServerHost}:${imageServerPort}/charts`;
+}
+/**
+ * Convert a local file path to a URL served by the image server.
+ */
+function filePathToUrl(filePath) {
+    const filename = node_path_1.default.basename(filePath);
+    return `${getImageUrlPrefix()}/${filename}`;
+}
+/**
+ * Check if the image server has been started.
+ */
+function isImageServerRunning() {
+    return imageServerStarted;
+}

package/build/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { callTool } from "./callTool";
+export { generateChartUrl } from "./generate";
+export { zodToJsonSchema } from "./schema";

package/build/utils/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodToJsonSchema = exports.generateChartUrl = exports.callTool = void 0;
+var callTool_1 = require("./callTool.js");
+Object.defineProperty(exports, "callTool", { enumerable: true, get: function () { return callTool_1.callTool; } });
+var generate_1 = require("./generate.js");
+Object.defineProperty(exports, "generateChartUrl", { enumerable: true, get: function () { return generate_1.generateChartUrl; } });
+var schema_1 = require("./schema.js");
+Object.defineProperty(exports, "zodToJsonSchema", { enumerable: true, get: function () { return schema_1.zodToJsonSchema; } });

package/build/utils/local-render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Get (and ensure exists) the output directory for chart images.
+ */
+export declare function getOutputDir(): string;
+/**
+ * Override the output directory (e.g. from env var).
+ */
+export declare function setOutputDir(dir: string): void;
+/**
+ * Render a G2 spec to a PNG file locally using @antv/g2-ssr.
+ * Returns the file path to the generated PNG image.
+ */
+export declare function renderG2SpecToFile(spec: Record<string, any>, width?: number, height?: number): Promise<string>;
+/**
+ * Render a G2 spec to a PNG buffer.
+ */
+export declare function renderG2SpecToBuffer(spec: Record<string, any>, width?: number, height?: number): Promise<Buffer>;

package/build/utils/local-render.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOutputDir = getOutputDir;
+exports.setOutputDir = setOutputDir;
+exports.renderG2SpecToFile = renderG2SpecToFile;
+exports.renderG2SpecToBuffer = renderG2SpecToBuffer;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = require("./logger.js");
+let createChartFn = null;
+function getCreateChart() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!createChartFn) {
+            const mod = yield Promise.resolve().then(() => __importStar(require("@antv/g2-ssr")));
+            createChartFn = mod.createChart;
+        }
+        return createChartFn;
+    });
+}
+/** Directory where rendered chart images are stored */
+let outputDir = node_path_1.default.join(node_os_1.default.tmpdir(), "mcp-chart-images");
+/**
+ * Get (and ensure exists) the output directory for chart images.
+ */
+function getOutputDir() {
+    try {
+        if (!node_fs_1.default.existsSync(outputDir)) {
+            node_fs_1.default.mkdirSync(outputDir, { recursive: true });
+        }
+    }
+    catch (err) {
+        logger_1.logger.error(`Failed to create chart image directory: ${outputDir}`, err);
+        throw new Error(`Cannot create chart image directory '${outputDir}': ${err.message}`);
+    }
+    return outputDir;
+}
+/**
+ * Override the output directory (e.g. from env var).
+ */
+function setOutputDir(dir) {
+    outputDir = dir;
+}
+/**
+ * Render a G2 spec to a PNG file locally using @antv/g2-ssr.
+ * Returns the file path to the generated PNG image.
+ */
+function renderG2SpecToFile(spec_1) {
+    return __awaiter(this, arguments, void 0, function* (
+    // biome-ignore lint/suspicious/noExplicitAny: G2 spec is loosely typed
+    spec, width = 600, height = 400) {
+        const createChart = yield getCreateChart();
+        const chart = yield createChart(Object.assign({ width,
+            height, imageType: "png" }, spec));
+        const dir = getOutputDir();
+        const filename = `chart-${Date.now()}-${node_crypto_1.default.randomUUID().slice(0, 8)}.png`;
+        const filePath = node_path_1.default.join(dir, filename);
+        chart.exportToFile(filePath.replace(/\.png$/, ""));
+        logger_1.logger.info(`Chart rendered locally: ${filePath}`);
+        return filePath;
+    });
+}
+/**
+ * Render a G2 spec to a PNG buffer.
+ */
+function renderG2SpecToBuffer(spec_1) {
+    return __awaiter(this, arguments, void 0, function* (
+    // biome-ignore lint/suspicious/noExplicitAny: G2 spec is loosely typed
+    spec, width = 600, height = 400) {
+        const createChart = yield getCreateChart();
+        const chart = yield createChart(Object.assign({ width,
+            height, imageType: "png" }, spec));
+        return chart.toBuffer();
+    });
+}

package/build/utils/logger.d.ts

@@ -0,0 +1,28 @@
+declare function setIsStdio(isStdio: boolean): void;
+/**
+ * Log info message
+ */
+declare function info(message: string, ...args: unknown[]): void;
+/**
+ * Log warning message
+ */
+declare function warn(message: string, ...args: unknown[]): void;
+/**
+ * Log error message
+ */
+declare function error(message: string, error?: unknown): void;
+/**
+ * Log success message
+ */
+declare function success(message: string, ...args: unknown[]): void;
+/**
+ * Logger object for backward compatibility
+ */
+export declare const logger: {
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    success: typeof success;
+    setIsStdio: typeof setIsStdio;
+};
+export {};

package/build/utils/logger.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * Unified logger for consistent logging across the application
+ */
+const prefix = "[MCP-Server-Chart]";
+/**
+ * Indicates if the logger is in stdio mode.
+ * When true, logs are directed to stderr for info, warn, and success messages, using console.error.
+ * When false, logs are directed to stdout.
+ */
+let IS_STDIO = true;
+function setIsStdio(isStdio) {
+    IS_STDIO = isStdio;
+}
+function getPrefix() {
+    const timestamp = new Date().toISOString();
+    return `${prefix} ${timestamp}`;
+}
+/**
+ * Log info message
+ */
+function info(message, ...args) {
+    const fn = IS_STDIO ? console.error : console.log;
+    fn(`${getPrefix()} ℹ️  ${message}`, ...args);
+}
+/**
+ * Log warning message
+ */
+function warn(message, ...args) {
+    const fn = IS_STDIO ? console.warn : console.log;
+    fn(`${getPrefix()} ⚠️  ${message}`, ...args);
+}
+/**
+ * Log error message
+ */
+function error(message, error) {
+    console.error(`${getPrefix()} ❌ ${message}`, error || "");
+}
+/**
+ * Log success message
+ */
+function success(message, ...args) {
+    const fn = IS_STDIO ? console.error : console.log;
+    fn(`${getPrefix()} ✅ ${message}`, ...args);
+}
+/**
+ * Logger object for backward compatibility
+ */
+exports.logger = {
+    info,
+    warn,
+    error,
+    success,
+    setIsStdio,
+};

package/build/utils/schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const zodToJsonSchema: (schema: Record<string, z.ZodType<any>>) => z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    [x: string]: z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>;
+}, z.core.$strip>>;

package/build/utils/schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodToJsonSchema = void 0;
+const zod_1 = require("zod");
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+const zodToJsonSchema = (schema) => {
+    return zod_1.z.object(schema).toJSONSchema({
+        io: "input",
+        target: "draft-07",
+    });
+};
+exports.zodToJsonSchema = zodToJsonSchema;

package/build/utils/spec-translator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Translates MCP server chart input arguments into @antv/g2 spec format.
+ * Each chart type's custom schema is mapped to a G2 declarative spec
+ * that can be rendered by @antv/g2-ssr.
+ */
+type Args = Record<string, any>;
+/**
+ * Translate an MCP chart type + args into a G2 spec.
+ * Returns null for unknown chart types.
+ */
+export declare function translateToG2Spec(chartType: string, args: Args): object | null;
+export {};