windows-print-mcp 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lplplp101
+
+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

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# windows-print-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An MCP server that lets Claude (or any MCP client) **print PDF files on your Windows PC**.
+
+> 한국어 설명은 [아래](#한국어)에 있습니다.
+
+Ask things like *"Print the PDF in my Downloads folder, pages 1-3, two copies, black and white"* and it goes straight to your printer.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `list_printers` | Lists installed printers and marks the default one |
+| `print_pdf` | Prints a PDF. Options: `printer`, `copies` (1–20), `pages` (e.g. `1-3,5`), `monochrome`, `duplex` (long edge) |
+
+## Requirements
+
+- Windows 10 or 11
+- [Node.js](https://nodejs.org) 18 or newer
+
+## Install
+
+### Claude Desktop
+
+Open **Settings → Developer → Edit Config** and add this to `claude_desktop_config.json`
+(if `mcpServers` already exists, add only the `"print"` entry inside it):
+
+```json
+{
+  "mcpServers": {
+    "print": {
+      "command": "npx",
+      "args": ["-y", "windows-print-mcp"]
+    }
+  }
+}
+```
+
+Fully quit Claude Desktop (tray icon → Quit) and start it again.
+
+### Claude Code
+
+```bash
+claude mcp add print -- npx -y windows-print-mcp
+```
+
+### Other clients (Cursor, VS Code, …)
+
+Use command `npx` with args `-y windows-print-mcp` over stdio.
+
+## How it works
+
+Each page is rendered with the built-in Windows PDF engine (`Windows.Data.Pdf`, 300 DPI) and sent to the printer through .NET `System.Drawing.Printing`. No extra PDF viewer needs to be installed.
+
+## Notes
+
+- Only `.pdf` files can be printed. Paths can be absolute (`C:\Users\me\Downloads\a.pdf`) or start with `~`.
+- Duplex only works if the printer supports automatic two-sided printing.
+- Printing uses real paper and ink — your MCP client will normally ask before calling `print_pdf`.
+
+## License
+
+MIT
+
+---
+
+## 한국어
+
+Claude가 **내 Windows PC에 연결된 프린터로 PDF를 바로 인쇄**할 수 있게 해 주는 MCP 커넥터입니다.
+"다운로드 폴더에 있는 PDF 1~3쪽만 흑백으로 2부 뽑아 줘"처럼 말하면 됩니다.
+
+### 도구
+
+- `list_printers` : 설치된 프린터 목록과 기본 프린터
+- `print_pdf` : PDF 인쇄 (프린터, 매수, 쪽 범위, 흑백, 양면 선택)
+
+### 설치 (Claude 데스크톱 앱)
+
+1. [Node.js](https://nodejs.org) LTS 버전을 설치합니다.
+2. Claude 앱 **설정 → 개발자 → 구성 편집**을 눌러 `claude_desktop_config.json`을 엽니다.
+3. 아래 내용을 넣습니다. 이미 `mcpServers`가 있으면 `"print"` 항목만 그 안에 추가하세요.
+
+```json
+{
+  "mcpServers": {
+    "print": {
+      "command": "npx",
+      "args": ["-y", "windows-print-mcp"]
+    }
+  }
+}
+```
+
+4. Claude 앱을 완전히 종료(트레이 아이콘 → 종료)했다가 다시 켭니다.
+
+양면 인쇄는 자동 양면 기능이 있는 프린터에서만 됩니다.

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "windows-print-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "MCP server that lets Claude (or any MCP client) print PDF files on a Windows PC",
+  "type": "module",
+  "main": "server.js",
+  "bin": {
+    "windows-print-mcp": "server.js"
+  },
+  "files": [
+    "server.js",
+    "print.ps1",
+    "README.md",
+    "LICENSE"
+  ],
+  "mcpName": "io.github.lplplp101/windows-print-mcp",
+  "os": ["win32"],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "mcp-server", "model-context-protocol", "claude", "print", "printer", "pdf", "windows"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lplplp101/print-mcp.git"
+  },
+  "homepage": "https://github.com/lplplp101/print-mcp#readme",
+  "bugs": "https://github.com/lplplp101/print-mcp/issues",
+  "author": "lplplp101",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "pdf-to-printer": "^5.8.1",
+    "zod": "^3.25.0"
+  }
+}

package/print.ps1

@@ -0,0 +1,76 @@
+param(
+  [Parameter(Mandatory=$true)][string]$Path,
+  [string]$Printer = "",
+  [int]$Copies = 1,
+  [string]$Pages = "",
+  [switch]$Mono,
+  [switch]$Duplex,
+  [int]$Dpi = 300
+)
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [Text.Encoding]::UTF8
+Add-Type -AssemblyName System.Runtime.WindowsRuntime
+Add-Type -AssemblyName System.Drawing
+$null = [Windows.Storage.StorageFile, Windows.Storage, ContentType = WindowsRuntime]
+$null = [Windows.Data.Pdf.PdfDocument, Windows.Data.Pdf, ContentType = WindowsRuntime]
+$null = [Windows.Storage.Streams.InMemoryRandomAccessStream, Windows.Storage.Streams, ContentType = WindowsRuntime]
+
+$ext = [System.WindowsRuntimeSystemExtensions].GetMethods()
+$asTaskOp = $ext | Where-Object { $_.Name -eq 'AsTask' -and $_.GetParameters().Count -eq 1 -and $_.GetParameters()[0].ParameterType.Name -eq 'IAsyncOperation`1' } | Select-Object -First 1
+$asTaskAct = $ext | Where-Object { $_.Name -eq 'AsTask' -and $_.GetParameters().Count -eq 1 -and $_.GetParameters()[0].ParameterType.Name -eq 'IAsyncAction' } | Select-Object -First 1
+function AwaitOp($op, [Type]$t) { $task = $asTaskOp.MakeGenericMethod($t).Invoke($null, @($op)); $task.Wait() | Out-Null; $task.Result }
+function AwaitAct($op) { $task = $asTaskAct.Invoke($null, @($op)); $task.Wait() | Out-Null }
+
+$file = AwaitOp ([Windows.Storage.StorageFile]::GetFileFromPathAsync($Path)) ([Windows.Storage.StorageFile])
+$doc = AwaitOp ([Windows.Data.Pdf.PdfDocument]::LoadFromFileAsync($file)) ([Windows.Data.Pdf.PdfDocument])
+$count = [int]$doc.PageCount
+
+$want = New-Object 'System.Collections.Generic.HashSet[int]'
+if ([string]::IsNullOrWhiteSpace($Pages)) { 1..$count | ForEach-Object { [void]$want.Add($_) } }
+else {
+  foreach ($part in $Pages.Split(',')) {
+    $p = $part.Trim(); if (-not $p) { continue }
+    if ($p -match '^(\d+)-(\d+)$') { [int]$Matches[1]..[int]$Matches[2] | ForEach-Object { [void]$want.Add($_) } }
+    elseif ($p -match '^\d+$') { [void]$want.Add([int]$p) }
+    else { throw "Bad page range: $p" }
+  }
+}
+
+$images = New-Object 'System.Collections.Generic.List[System.Drawing.Image]'
+for ($i = 0; $i -lt $count; $i++) {
+  if (-not $want.Contains($i + 1)) { continue }
+  $page = $doc.GetPage([uint32]$i)
+  $opt = New-Object Windows.Data.Pdf.PdfPageRenderOptions
+  $opt.DestinationWidth = [uint32][math]::Round($page.Size.Width * $Dpi / 96)
+  $opt.DestinationHeight = [uint32][math]::Round($page.Size.Height * $Dpi / 96)
+  $ras = New-Object Windows.Storage.Streams.InMemoryRandomAccessStream
+  AwaitAct ($page.RenderToStreamAsync($ras, $opt))
+  $ras.Seek(0)
+  $net = [System.IO.WindowsRuntimeStreamExtensions]::AsStreamForRead($ras)
+  $ms = New-Object System.IO.MemoryStream
+  $net.CopyTo($ms); $ms.Position = 0
+  $images.Add([System.Drawing.Image]::FromStream($ms))
+  $page.Dispose()
+}
+if ($images.Count -eq 0) { throw "No pages selected (document has $count pages)" }
+
+$pd = New-Object System.Drawing.Printing.PrintDocument
+if ($Printer) { $pd.PrinterSettings.PrinterName = $Printer }
+if (-not $pd.PrinterSettings.IsValid) { throw "Printer not found: $Printer" }
+$pd.PrinterSettings.Copies = [int16]$Copies
+$pd.DefaultPageSettings.Color = -not $Mono
+if ($Duplex) { $pd.PrinterSettings.Duplex = [System.Drawing.Printing.Duplex]::Vertical }
+$pd.DocumentName = [IO.Path]::GetFileName($Path)
+$pd.PrintController = New-Object System.Drawing.Printing.StandardPrintController
+$script:idx = 0
+$pd.add_PrintPage({
+  param($s, $e)
+  $img = $images[$script:idx]
+  $pb = $e.PageBounds
+  $e.Graphics.InterpolationMode = [System.Drawing.Drawing2D.InterpolationMode]::HighQualityBicubic
+  $e.Graphics.DrawImage($img, [float](-$e.PageSettings.HardMarginX), [float](-$e.PageSettings.HardMarginY), [float]$pb.Width, [float]$pb.Height)
+  $script:idx++
+  $e.HasMorePages = ($script:idx -lt $images.Count)
+})
+$pd.Print()
+Write-Output ("OK pages={0} printer={1} copies={2}" -f $images.Count, $pd.PrinterSettings.PrinterName, $Copies)

package/server.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execFile } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+if (process.platform !== "win32") {
+  console.error("windows-print-mcp only runs on Windows.");
+  process.exit(1);
+}
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const PS = path.join(process.env.SystemRoot || "C:\\Windows", "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+
+function psPrint(file, { printer, copies, pages, monochrome, duplex }) {
+  const args = ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", path.join(HERE, "print.ps1"), "-Path", file, "-Copies", String(copies || 1)];
+  if (printer) args.push("-Printer", printer);
+  if (pages) args.push("-Pages", pages);
+  if (monochrome) args.push("-Mono");
+  if (duplex) args.push("-Duplex");
+  return new Promise((resolve, reject) => {
+    execFile(PS, args, { timeout: 180000, windowsHide: true, encoding: "utf8" }, (err, stdout, stderr) => {
+      if (err) reject(new Error((stderr || stdout || err.message).trim()));
+      else resolve(stdout.trim());
+    });
+  });
+}
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const require = createRequire(import.meta.url);
+const ptp = require("pdf-to-printer");
+
+const text = (s) => ({ content: [{ type: "text", text: s }] });
+const fail = (s) => ({ content: [{ type: "text", text: s }], isError: true });
+
+function resolvePdf(p) {
+  let f = p.trim().replace(/^"|"$/g, "");
+  if (f.startsWith("~")) f = path.join(os.homedir(), f.slice(1));
+  f = path.resolve(f);
+  if (path.extname(f).toLowerCase() !== ".pdf") throw new Error("Only PDF files can be printed: " + f);
+  if (!fs.existsSync(f) || !fs.statSync(f).isFile()) throw new Error("File not found: " + f);
+  return f;
+}
+
+const server = new McpServer({ name: "windows-print-mcp", version: "1.0.0" });
+
+server.registerTool(
+  "list_printers",
+  {
+    title: "List printers",
+    description: "List printers installed on this Windows PC and show which one is the default.",
+    inputSchema: {},
+  },
+  async () => {
+    try {
+      const printers = await ptp.getPrinters();
+      const def = await ptp.getDefaultPrinter().catch(() => null);
+      if (!printers.length) return text("No printers are installed.");
+      const lines = printers.map((p) => `- ${p.name}${def && def.name === p.name ? " (default)" : ""}`);
+      return text(lines.join("\n"));
+    } catch (e) {
+      return fail("Could not list printers: " + e.message);
+    }
+  }
+);
+
+server.registerTool(
+  "print_pdf",
+  {
+    title: "Print PDF",
+    description:
+      "Send a PDF file on this Windows PC to a printer. Use an absolute Windows path (e.g. C:\\Users\\me\\Downloads\\file.pdf) or ~\\Downloads\\file.pdf. Omit printer to use the default printer.",
+    inputSchema: {
+      path: z.string().describe("Path to the PDF file on this PC"),
+      printer: z.string().optional().describe("Printer name from list_printers; default printer if omitted"),
+      copies: z.number().int().min(1).max(20).optional().describe("Number of copies (default 1)"),
+      pages: z.string().optional().describe("Page range like '1' or '1-3,5'; all pages if omitted"),
+      monochrome: z.boolean().optional().describe("Print in black and white"),
+      duplex: z.boolean().optional().describe("Print on both sides (long edge)"),
+    },
+  },
+  async ({ path: p, printer, copies, pages, monochrome, duplex }) => {
+    try {
+      const file = resolvePdf(p);
+      const out = await psPrint(file, { printer, copies, pages, monochrome, duplex });
+      const def = printer || (await ptp.getDefaultPrinter().catch(() => null))?.name || "default printer";
+      return text(`Print job sent.\nFile: ${file}\nPrinter: ${def}\nCopies: ${copies || 1}\n${out}`);
+    } catch (e) {
+      return fail("Printing failed: " + e.message);
+    }
+  }
+);
+
+await server.connect(new StdioServerTransport());