terminal-png-mcp 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poe Platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# terminal-png-mcp
+
+MCP server that exposes `terminal-png` as a tool over stdio.
+
+## Tool: `render_terminal_png`
+
+Renders ANSI terminal output as a PNG image.
+
+| Input      | Type    | Required | Description                          |
+| ---------- | ------- | -------- | ------------------------------------ |
+| `ansiText` | string  | yes      | ANSI-formatted terminal output       |
+| `padding`  | number  | no       | Padding in pixels around the content |
+| `window`   | boolean | no       | Whether to render window chrome      |
+
+Returns: PNG image content block.
+
+## Usage
+
+```json
+{
+  "mcpServers": {
+    "terminal-png": {
+      "command": "terminal-png-mcp"
+    }
+  }
+}
+```
+
+## Configuration Options
+
+Configuration is supplied through MCP tool arguments. There is no package-level config file.
+
+## Environment Variables
+
+This package does not read public environment variables.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { createTerminalPngMcpServer } from "./index.js";
+await createTerminalPngMcpServer().listen();

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function createTerminalPngMcpServer(): import("tiny-stdio-mcp-server").Server;

package/dist/index.js

@@ -0,0 +1,30 @@
+import { createServer, Image } from "tiny-stdio-mcp-server";
+import { renderTerminalPng } from "terminal-png";
+const schema = {
+    type: "object",
+    properties: {
+        ansiText: {
+            type: "string",
+            description: "ANSI-formatted terminal output to render"
+        },
+        padding: {
+            type: "integer",
+            minimum: 0,
+            description: "Padding in pixels around the content"
+        },
+        window: {
+            type: "boolean",
+            description: "Whether to render a window chrome around the screenshot"
+        }
+    },
+    required: ["ansiText"]
+};
+export function createTerminalPngMcpServer() {
+    return createServer({
+        name: "terminal-png-mcp",
+        version: "0.1.0"
+    }).tool("render_terminal_png", "Renders ANSI terminal output as a PNG image", schema, async ({ ansiText, padding, window }) => {
+        const buffer = await renderTerminalPng(ansiText, { padding, window });
+        return Image.fromBytes(buffer, "image/png");
+    });
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "terminal-png-mcp",
+  "version": "0.1.5",
+  "description": "MCP server that exposes terminal PNG rendering as a tool.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "terminal-png-mcp": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/guard-package-dist.mjs && tsc",
+    "prepack": "node ../../scripts/set-bin-executable.mjs",
+    "prepublishOnly": "tsc"
+  },
+  "files": [
+    "LICENSE",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/poe-platform/poe-code.git",
+    "directory": "packages/terminal-png-mcp"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "terminal",
+    "png",
+    "ansi"
+  ],
+  "dependencies": {
+    "terminal-png": "0.1.5",
+    "tiny-stdio-mcp-server": "^0.1.0"
+  }
+}