@sylphx/pdf-reader-mcp 2.0.8 → 2.2.0

package/README.md

@@ -593,6 +593,63 @@ Restart MCP client completely.
 
 ---
 
+## 🌐 HTTP Transport (Remote Access)
+
+By default, PDF Reader MCP uses stdio transport for local use. You can also run it as an HTTP server for remote access from multiple machines.
+
+### Quick Start
+
+```bash
+# Run as HTTP server on port 8080
+MCP_TRANSPORT=http npx @sylphx/pdf-reader-mcp
+```
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_TRANSPORT` | `stdio` | Transport type: `stdio` or `http` |
+| `MCP_HTTP_PORT` | `8080` | HTTP server port |
+| `MCP_HTTP_HOST` | `0.0.0.0` | HTTP server hostname |
+| `MCP_API_KEY` | - | Optional API key for authentication |
+
+### Docker Deployment
+
+```dockerfile
+FROM oven/bun:1
+WORKDIR /app
+RUN bun add @sylphx/pdf-reader-mcp
+ENV MCP_TRANSPORT=http
+ENV MCP_HTTP_PORT=8080
+EXPOSE 8080
+CMD ["bun", "node_modules/@sylphx/pdf-reader-mcp/dist/index.js"]
+```
+
+### MCP Client Configuration (HTTP)
+
+```json
+{
+  "servers": {
+    "pdf-reader": {
+      "type": "http",
+      "url": "https://your-server.com/mcp",
+      "headers": {
+        "X-API-Key": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/mcp` | POST | JSON-RPC endpoint |
+| `/mcp/health` | GET | Health check |
+
+---
+
 ## 🏗️ Architecture
 
 ### Tech Stack
@@ -772,12 +829,11 @@ Special thanks to the open source community ❤️
 This project uses the following [@sylphx](https://github.com/SylphxAI) packages:
 
 - [@sylphx/mcp-server-sdk](https://github.com/SylphxAI/mcp-server-sdk) - MCP server framework
+- [@sylphx/vex](https://github.com/SylphxAI/vex) - Schema validation
 - [@sylphx/biome-config](https://github.com/SylphxAI/biome-config) - Biome configuration
 - [@sylphx/tsconfig](https://github.com/SylphxAI/tsconfig) - TypeScript configuration
 - [@sylphx/bump](https://github.com/SylphxAI/bump) - Version management
 - [@sylphx/doctor](https://github.com/SylphxAI/doctor) - Project health checker
-- [@sylphx/leaf](https://github.com/SylphxAI/leaf) - Documentation framework
-- [@sylphx/leaf-theme-default](https://github.com/SylphxAI/leaf-theme-default) - Documentation theme
 
 ---
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { createServer, stdio } from "@sylphx/mcp-server-sdk";
+import { createServer, http, stdio } from "@sylphx/mcp-server-sdk";
 
 // src/handlers/readPdf.ts
 import { image, text, tool, toolError } from "@sylphx/mcp-server-sdk";
@@ -316,6 +316,7 @@ var extractPageContent = async (pdfDocument, pageNum, includeImages, sourceDescr
 
 // src/pdf/loader.ts
 import fs from "node:fs/promises";
+import { createRequire } from "node:module";
 import { getDocument } from "pdfjs-dist/legacy/build/pdf.mjs";
 
 // src/utils/errors.ts
@@ -341,6 +342,8 @@ var resolvePath = (userPath) => {
 
 // src/pdf/loader.ts
 var logger3 = createLogger("Loader");
+var require2 = createRequire(import.meta.url);
+var CMAP_URL = require2.resolve("pdfjs-dist/package.json").replace("package.json", "cmaps/");
 var MAX_PDF_SIZE = 100 * 1024 * 1024;
 var loadPdfDocument = async (source, sourceDescription) => {
   let pdfDataSource;
@@ -370,7 +373,12 @@ var loadPdfDocument = async (source, sourceDescription) => {
     }
     throw new PdfError(errorCode, `Failed to prepare PDF source ${sourceDescription}. Reason: ${message}`, { cause: err instanceof Error ? err : undefined });
   }
-  const loadingTask = getDocument(pdfDataSource);
+  const documentParams = pdfDataSource instanceof Uint8Array ? { data: pdfDataSource } : pdfDataSource;
+  const loadingTask = getDocument({
+    ...documentParams,
+    cMapUrl: CMAP_URL,
+    cMapPacked: true
+  });
   try {
     return await loadingTask.promise;
   } catch (err) {
@@ -501,7 +509,16 @@ var processSingleSource = async (source, options) => {
       output.warnings = warnings;
     }
     if (pagesToProcess.length > 0) {
-      const pageContents = await Promise.all(pagesToProcess.map((pageNum) => extractPageContent(pdfDocument, pageNum, options.includeImages, sourceDescription)));
+      const MAX_CONCURRENT_PAGES = 5;
+      const pageContents = [];
+      for (let i = 0;i < pagesToProcess.length; i += MAX_CONCURRENT_PAGES) {
+        const batch = pagesToProcess.slice(i, i + MAX_CONCURRENT_PAGES);
+        const batchResults = await Promise.all(batch.map((pageNum) => extractPageContent(pdfDocument, pageNum, options.includeImages, sourceDescription)));
+        pageContents.push(...batchResults);
+        if (i + MAX_CONCURRENT_PAGES < pagesToProcess.length) {
+          await new Promise((resolve) => setImmediate(resolve));
+        }
+      }
       output.page_contents = pageContents.map((items, idx) => ({
         page: pagesToProcess[idx],
         items
@@ -590,29 +607,60 @@ var readPdf = tool().description("Reads content/metadata/images from one or more
     if (!result.success || !result.data?.page_contents)
       continue;
     for (const pageContent of result.data.page_contents) {
+      const pageTextParts = [];
+      const pageImages = [];
       for (const item of pageContent.items) {
         if (item.type === "text" && item.textContent) {
-          content.push(text(item.textContent));
+          pageTextParts.push(item.textContent);
         } else if (item.type === "image" && item.imageData) {
-          content.push(image(item.imageData.data, "image/png"));
+          pageImages.push(item.imageData);
         }
       }
+      if (pageTextParts.length > 0) {
+        content.push(text(`[Page ${pageContent.page}]
+${pageTextParts.join(`
+`)}`));
+      }
+      for (const img of pageImages) {
+        content.push(image(img.data, "image/png"));
+      }
     }
   }
   return content;
 });
 
 // src/index.ts
+var transportType = process.env["MCP_TRANSPORT"] ?? "stdio";
+var httpPort = Number.parseInt(process.env["MCP_HTTP_PORT"] ?? "8080", 10);
+var httpHost = process.env["MCP_HTTP_HOST"] ?? "0.0.0.0";
+var apiKey = process.env["MCP_API_KEY"];
+function createTransport() {
+  if (transportType === "http") {
+    return http({
+      port: httpPort,
+      hostname: httpHost,
+      cors: "*"
+    });
+  }
+  return stdio();
+}
 var server = createServer({
   name: "pdf-reader-mcp",
-  version: "1.3.0",
+  version: "2.1.0",
   instructions: "MCP Server for reading PDF files and extracting text, metadata, images, and page information.",
   tools: { read_pdf: readPdf },
-  transport: stdio()
+  transport: createTransport()
 });
 async function main() {
   await server.start();
-  if (process.env["DEBUG_MCP"]) {
+  if (transportType === "http") {
+    console.log(`[PDF Reader MCP] Server running on http://${httpHost}:${httpPort}/mcp`);
+    console.log(`[PDF Reader MCP] Health check: http://${httpHost}:${httpPort}/mcp/health`);
+    if (apiKey) {
+      console.log("[PDF Reader MCP] API key authentication enabled (X-API-Key header)");
+    }
+    console.log("[PDF Reader MCP] Project root:", process.cwd());
+  } else if (process.env["DEBUG_MCP"]) {
     console.error("[PDF Reader MCP] Server running on stdio");
     console.error("[PDF Reader MCP] Project root:", process.cwd());
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sylphx/pdf-reader-mcp",
-  "version": "2.0.8",
+  "version": "2.2.0",
   "description": "An MCP server providing tools to read PDF files.",
   "type": "module",
   "bin": {
@@ -12,9 +12,7 @@
     "LICENSE"
   ],
   "exports": {
-    ".": {
-      "import": "./dist/index.js"
-    }
+    ".": "./dist/index.js"
   },
   "publishConfig": {
     "access": "public"
@@ -45,7 +43,7 @@
     "tool"
   ],
   "scripts": {
-    "build": "bunup",
+    "build": "bunup --no-dts",
     "watch": "tsc --watch",
     "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
     "test": "bun test",
@@ -58,9 +56,9 @@
     "check": "biome check .",
     "check:fix": "biome check --write .",
     "validate": "bun run check && bun run test",
-    "docs:dev": "bunx @sylphx/leaf dev docs",
-    "docs:build": "bunx @sylphx/leaf build docs",
-    "docs:preview": "bunx @sylphx/leaf preview docs",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
     "benchmark": "bun bench",
@@ -77,28 +75,25 @@
     "pdfjs-dist": "^5.4.449",
     "pngjs": "^7.0.0"
   },
+  "overrides": {
+    "esbuild": "^0.25.0",
+    "preact": "^10.28.2"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.3.8",
-    "@solidjs/router": "^0.15.4",
     "@sylphx/biome-config": "^0.4.1",
     "@sylphx/bump": "^1.6.1",
     "@sylphx/doctor": "^1.32.1",
-    "@sylphx/leaf": "^1.0.0",
-    "@sylphx/leaf-theme-default": "^1.0.0",
     "@sylphx/tsconfig": "^0.3.1",
     "@types/glob": "^8.1.0",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.3",
     "@types/pngjs": "^6.0.5",
-    "bunup": "^0.16.10",
+    "bunup": "0.16.10",
     "lefthook": "^2.0.7",
-    "solid-js": "^1.9.10",
     "typedoc": "^0.28.15",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3",
-    "vite": "^7.2.6"
+    "vitepress": "^1.6.4"
   },
-  "packageManager": "bun@1.3.1",
-  "overrides": {
-    "js-yaml": "^4.1.0"
-  }
+  "packageManager": "bun@1.3.1"
 }