nebula-notebook-mcp 0.1.0

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/imageResize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Image Resize Utility
+ *
+ * Resizes base64 PNG images to fit within Claude API limits.
+ * Claude's multi-image requests require each image to be ≤2000 pixels in any dimension.
+ */
+/**
+ * Resize a base64 PNG image if it exceeds the maximum dimension.
+ * Returns the original if already within limits or if resizing fails.
+ *
+ * @param base64Data - Base64 encoded PNG data (without data URL prefix)
+ * @param maxDimension - Maximum allowed dimension (default: 2000)
+ * @returns Resized base64 PNG data
+ */
+export declare function resizeImageIfNeeded(base64Data: string, maxDimension?: number): Promise<string>;
+/**
+ * Check image dimensions without resizing.
+ * Returns null if dimensions can't be determined.
+ */
+export declare function getImageDimensions(base64Data: string): Promise<{
+    width: number;
+    height: number;
+} | null>;
+//# sourceMappingURL=imageResize.d.ts.map

package/dist/utils/imageResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageResize.d.ts","sourceRoot":"","sources":["../../src/utils/imageResize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAWnD"}

package/dist/utils/imageResize.js

@@ -0,0 +1,67 @@
+/**
+ * Image Resize Utility
+ *
+ * Resizes base64 PNG images to fit within Claude API limits.
+ * Claude's multi-image requests require each image to be ≤2000 pixels in any dimension.
+ */
+import sharp from 'sharp';
+const DEFAULT_MAX_DIMENSION = 2000;
+/**
+ * Resize a base64 PNG image if it exceeds the maximum dimension.
+ * Returns the original if already within limits or if resizing fails.
+ *
+ * @param base64Data - Base64 encoded PNG data (without data URL prefix)
+ * @param maxDimension - Maximum allowed dimension (default: 2000)
+ * @returns Resized base64 PNG data
+ */
+export async function resizeImageIfNeeded(base64Data, maxDimension = DEFAULT_MAX_DIMENSION) {
+    try {
+        const buffer = Buffer.from(base64Data, 'base64');
+        const image = sharp(buffer);
+        const metadata = await image.metadata();
+        const { width, height } = metadata;
+        if (!width || !height) {
+            return base64Data; // Can't determine size, return original
+        }
+        // Check if resize is needed
+        if (width <= maxDimension && height <= maxDimension) {
+            return base64Data.trim(); // Already within limits, but trim any whitespace
+        }
+        // Calculate new dimensions maintaining aspect ratio
+        const scale = Math.min(maxDimension / width, maxDimension / height);
+        const newWidth = Math.round(width * scale);
+        const newHeight = Math.round(height * scale);
+        // Resize and convert back to base64
+        const resizedBuffer = await image
+            .resize(newWidth, newHeight, {
+            fit: 'inside',
+            withoutEnlargement: true,
+        })
+            .png()
+            .toBuffer();
+        return resizedBuffer.toString('base64').trim();
+    }
+    catch (error) {
+        // If resizing fails, return original (trimmed)
+        console.error('[ImageResize] Failed to resize image:', error);
+        return base64Data.trim();
+    }
+}
+/**
+ * Check image dimensions without resizing.
+ * Returns null if dimensions can't be determined.
+ */
+export async function getImageDimensions(base64Data) {
+    try {
+        const buffer = Buffer.from(base64Data, 'base64');
+        const metadata = await sharp(buffer).metadata();
+        if (metadata.width && metadata.height) {
+            return { width: metadata.width, height: metadata.height };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=imageResize.js.map

package/dist/utils/imageResize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageResize.js","sourceRoot":"","sources":["../../src/utils/imageResize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,eAAuB,qBAAqB;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QAExC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC,CAAC,wCAAwC;QAC7D,CAAC;QAED,4BAA4B;QAC5B,IAAI,KAAK,IAAI,YAAY,IAAI,MAAM,IAAI,YAAY,EAAE,CAAC;YACpD,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,iDAAiD;QAC7E,CAAC;QAED,oDAAoD;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;QAE7C,oCAAoC;QACpC,MAAM,aAAa,GAAG,MAAM,KAAK;aAC9B,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC3B,GAAG,EAAE,QAAQ;YACb,kBAAkB,EAAE,IAAI;SACzB,CAAC;aACD,GAAG,EAAE;aACL,QAAQ,EAAE,CAAC;QAEd,OAAO,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+CAA+C;QAC/C,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChD,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/polling.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Adaptive polling utility with exponential backoff
+ *
+ * Starts with fast intervals (50ms) and gradually increases to max (1000ms)
+ * to balance responsiveness for quick operations with efficiency for long waits.
+ */
+export interface PollerConfig {
+    /** Initial polling interval in milliseconds (default: 50) */
+    initialInterval?: number;
+    /** Maximum polling interval in milliseconds (default: 1000) */
+    maxInterval?: number;
+    /** Backoff multiplier (default: 2 for exponential) */
+    backoffFactor?: number;
+}
+export declare class AdaptivePoller {
+    private currentInterval;
+    private config;
+    constructor(config?: PollerConfig);
+    /**
+     * Get current polling interval in milliseconds
+     */
+    getCurrentInterval(): number;
+    /**
+     * Increase polling interval using exponential backoff
+     */
+    incrementInterval(): void;
+    /**
+     * Reset polling interval to initial value
+     */
+    reset(): void;
+    /**
+     * Async sleep for current interval duration
+     */
+    wait(): Promise<void>;
+}
+/**
+ * Factory function for creating adaptive pollers
+ */
+export declare function createAdaptivePoller(config?: PollerConfig): AdaptivePoller;
+//# sourceMappingURL=polling.d.ts.map

package/dist/utils/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,GAAE,YAAiB;IASrC;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAOzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,CAE1E"}

package/dist/utils/polling.js

@@ -0,0 +1,49 @@
+/**
+ * Adaptive polling utility with exponential backoff
+ *
+ * Starts with fast intervals (50ms) and gradually increases to max (1000ms)
+ * to balance responsiveness for quick operations with efficiency for long waits.
+ */
+export class AdaptivePoller {
+    currentInterval;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            initialInterval: config.initialInterval ?? 50,
+            maxInterval: config.maxInterval ?? 1000,
+            backoffFactor: config.backoffFactor ?? 2
+        };
+        this.currentInterval = this.config.initialInterval;
+    }
+    /**
+     * Get current polling interval in milliseconds
+     */
+    getCurrentInterval() {
+        return this.currentInterval;
+    }
+    /**
+     * Increase polling interval using exponential backoff
+     */
+    incrementInterval() {
+        this.currentInterval = Math.min(this.currentInterval * this.config.backoffFactor, this.config.maxInterval);
+    }
+    /**
+     * Reset polling interval to initial value
+     */
+    reset() {
+        this.currentInterval = this.config.initialInterval;
+    }
+    /**
+     * Async sleep for current interval duration
+     */
+    async wait() {
+        await new Promise(resolve => setTimeout(resolve, this.currentInterval));
+    }
+}
+/**
+ * Factory function for creating adaptive pollers
+ */
+export function createAdaptivePoller(config) {
+    return new AdaptivePoller(config);
+}
+//# sourceMappingURL=polling.js.map

package/dist/utils/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/utils/polling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,OAAO,cAAc;IACjB,eAAe,CAAS;IACxB,MAAM,CAAyB;IAEvC,YAAY,SAAuB,EAAE;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,EAAE;YAC7C,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;YACvC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC;SACzC,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAChD,IAAI,CAAC,MAAM,CAAC,WAAW,CACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "nebula-notebook-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Nebula Notebook \u2014 lets agents (Claude Code, Codex, etc.) read, edit, and execute notebooks on a running Nebula server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nebula-notebook-mcp": "./bin/nebula-mcp.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "setup-mcp.js"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "jupyter",
+    "notebook",
+    "ai",
+    "claude"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jzthree/nebula-notebook.git",
+    "directory": "packages/mcp"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./notebook": "./dist/notebook/index.js",
+    "./mcp": "./dist/mcp/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "clean": "rm -rf dist",
+    "mcp": "node dist/mcp/index.js",
+    "setup-mcp": "node setup-mcp.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "glob": "^11.0.0",
+    "sharp": "^0.34.5",
+    "strip-ansi": "^7.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/sharp": "^0.31.1",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}