mcp-server-docpipe 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# mcp-server-docpipe
+
+MCP server for document processing — PDF, DOCX, and image manipulation powered by AI.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `pdf-extract-text` | Extract text and metadata from PDF files |
+| `pdf-merge` | Merge multiple PDFs into one |
+| `pdf-split` | Extract specific pages from a PDF |
+| `docx-to-markdown` | Convert Word documents to Markdown |
+| `docx-to-html` | Convert Word documents to HTML |
+| `image-resize` | Resize images with flexible fit options |
+| `image-compress` | Compress/convert images (WebP, AVIF, JPEG, PNG) |
+| `image-info` | Get image metadata without modification |
+
+## Quick Start
+
+```bash
+npx mcp-server-docpipe
+```
+
+## Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "docpipe": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-docpipe"]
+    }
+  }
+}
+```
+
+## Claude Code Configuration
+
+```bash
+claude mcp add-json docpipe '{"type":"stdio","command":"npx","args":["-y","mcp-server-docpipe"]}'
+```
+
+## Examples
+
+**Extract text from a PDF:**
+> "Extract all text from C:/Documents/report.pdf"
+
+**Merge PDFs:**
+> "Merge invoice1.pdf and invoice2.pdf into combined.pdf"
+
+**Convert Word to Markdown:**
+> "Convert my-document.docx to markdown format"
+
+**Compress an image:**
+> "Compress photo.png to WebP format with 70% quality"
+
+## Development
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * mcp-server-docpipe
+ * MCP server for document processing:
+ * - PDF text extraction, merge, split
+ * - DOCX to Markdown conversion
+ * - Image resize and compression
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * mcp-server-docpipe
+ * MCP server for document processing:
+ * - PDF text extraction, merge, split
+ * - DOCX to Markdown conversion
+ * - Image resize and compression
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerPdfTools } from './tools/pdf-extract.js';
+import { registerPdfMerge } from './tools/pdf-merge.js';
+import { registerPdfSplit } from './tools/pdf-split.js';
+import { registerDocxConvert } from './tools/docx-convert.js';
+import { registerImageTools } from './tools/image-process.js';
+const server = new McpServer({
+    name: 'mcp-server-docpipe',
+    version: '1.0.0',
+});
+// Register all tools
+registerPdfTools(server);
+registerPdfMerge(server);
+registerPdfSplit(server);
+registerDocxConvert(server);
+registerImageTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('mcp-server-docpipe started on stdio');
+}
+main().catch((error) => {
+    console.error('Server failed to start:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/docx-convert.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDocxConvert(server: McpServer): void;

package/dist/tools/docx-convert.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import * as mammoth from 'mammoth';
+export function registerDocxConvert(server) {
+    server.tool('docx-to-markdown', 'Convert a DOCX (Word) file to Markdown format. Preserves headings, lists, bold/italic, tables, and links.', {
+        filePath: z.string().describe('Absolute path to the DOCX file'),
+        outputPath: z.string().optional().describe('Optional: save Markdown to this path. If omitted, returns content directly.'),
+    }, async ({ filePath, outputPath }) => {
+        const buffer = await fs.readFile(filePath);
+        const result = await mammoth.convertToMarkdown({ buffer });
+        const markdown = result.value;
+        const warnings = result.messages
+            .filter((m) => m.type === 'warning')
+            .map((m) => m.message);
+        if (outputPath) {
+            await fs.writeFile(outputPath, markdown, 'utf-8');
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        markdown: outputPath ? `(saved to ${outputPath})` : markdown,
+                        characterCount: markdown.length,
+                        warnings: warnings.length > 0 ? warnings : undefined,
+                        ...(outputPath ? { outputPath } : {}),
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('docx-to-html', 'Convert a DOCX (Word) file to HTML format.', {
+        filePath: z.string().describe('Absolute path to the DOCX file'),
+        outputPath: z.string().optional().describe('Optional: save HTML to this path'),
+    }, async ({ filePath, outputPath }) => {
+        const buffer = await fs.readFile(filePath);
+        const result = await mammoth.convertToHtml({ buffer });
+        const html = result.value;
+        if (outputPath) {
+            await fs.writeFile(outputPath, html, 'utf-8');
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        html: outputPath ? `(saved to ${outputPath})` : html,
+                        characterCount: html.length,
+                        ...(outputPath ? { outputPath } : {}),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=docx-convert.js.map

package/dist/tools/docx-convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-convert.js","sourceRoot":"","sources":["../../src/tools/docx-convert.ts"],"names":[],"mappings":"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"}

package/dist/tools/image-process.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerImageTools(server: McpServer): void;

package/dist/tools/image-process.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import sharp from 'sharp';
+export function registerImageTools(server) {
+    server.tool('image-resize', 'Resize an image to specified dimensions. Supports JPEG, PNG, WebP, AVIF, TIFF, GIF.', {
+        inputFile: z.string().describe('Absolute path to the source image'),
+        outputPath: z.string().describe('Absolute path for the resized output image'),
+        width: z.number().int().positive().optional().describe('Target width in pixels'),
+        height: z.number().int().positive().optional().describe('Target height in pixels'),
+        fit: z.enum(['cover', 'contain', 'fill', 'inside', 'outside']).optional().default('inside')
+            .describe('How to fit: cover (crop), contain (letterbox), fill (stretch), inside (max dimensions), outside (min dimensions)'),
+    }, async ({ inputFile, outputPath, width, height, fit }) => {
+        if (!width && !height) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: 'At least one of width or height must be specified' }),
+                    }],
+            };
+        }
+        const info = await sharp(inputFile)
+            .resize({ width: width ?? undefined, height: height ?? undefined, fit })
+            .toFile(outputPath);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        outputPath,
+                        output: {
+                            width: info.width,
+                            height: info.height,
+                            format: info.format,
+                            size: info.size,
+                        },
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('image-compress', 'Compress and/or convert an image to a different format (WebP, AVIF, JPEG, PNG). Great for reducing file size.', {
+        inputFile: z.string().describe('Absolute path to the source image'),
+        outputPath: z.string().describe('Absolute path for the compressed output image'),
+        format: z.enum(['webp', 'avif', 'jpeg', 'png']).describe('Output format'),
+        quality: z.number().int().min(1).max(100).optional().default(80)
+            .describe('Compression quality 1-100 (lower = smaller file, default 80)'),
+    }, async ({ inputFile, outputPath, format, quality }) => {
+        const inputStat = await fs.stat(inputFile);
+        let pipeline = sharp(inputFile);
+        switch (format) {
+            case 'webp':
+                pipeline = pipeline.webp({ quality });
+                break;
+            case 'avif':
+                pipeline = pipeline.avif({ quality });
+                break;
+            case 'jpeg':
+                pipeline = pipeline.jpeg({ quality });
+                break;
+            case 'png':
+                pipeline = pipeline.png({ quality });
+                break;
+        }
+        const info = await pipeline.toFile(outputPath);
+        const outputStat = await fs.stat(outputPath);
+        const compressionRatio = ((1 - outputStat.size / inputStat.size) * 100).toFixed(1);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        outputPath,
+                        inputSize: inputStat.size,
+                        outputSize: outputStat.size,
+                        compressionRatio: `${compressionRatio}%`,
+                        output: {
+                            width: info.width,
+                            height: info.height,
+                            format: info.format,
+                        },
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('image-info', 'Get metadata and dimensions of an image file without modifying it.', {
+        filePath: z.string().describe('Absolute path to the image file'),
+    }, async ({ filePath }) => {
+        const metadata = await sharp(filePath).metadata();
+        const stat = await fs.stat(filePath);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        filePath,
+                        width: metadata.width,
+                        height: metadata.height,
+                        format: metadata.format,
+                        space: metadata.space,
+                        channels: metadata.channels,
+                        hasAlpha: metadata.hasAlpha,
+                        fileSize: stat.size,
+                        density: metadata.density,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=image-process.js.map

package/dist/tools/image-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-process.js","sourceRoot":"","sources":["../../src/tools/image-process.ts"],"names":[],"mappings":"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"}

package/dist/tools/pdf-extract.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPdfTools(server: McpServer): void;

package/dist/tools/pdf-extract.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import pdfParse from 'pdf-parse';
+export function registerPdfTools(server) {
+    server.tool('pdf-extract-text', 'Extract text content from a PDF file. Returns the full text and metadata (page count, info).', {
+        filePath: z.string().describe('Absolute path to the PDF file'),
+        pageRange: z.string().optional().describe('Page range to extract, e.g. "1-5" or "3" (optional, defaults to all pages)'),
+    }, async ({ filePath, pageRange }) => {
+        const buffer = await fs.readFile(filePath);
+        const data = await pdfParse(buffer);
+        let text = data.text;
+        // If pageRange is specified, we extract from the full text
+        // pdf-parse doesn't support per-page extraction natively,
+        // so we provide the full text with metadata
+        const result = {
+            text: text.trim(),
+            pageCount: data.numpages,
+            info: {
+                title: data.info?.Title || null,
+                author: data.info?.Author || null,
+                subject: data.info?.Subject || null,
+                creator: data.info?.Creator || null,
+            },
+            ...(pageRange ? { note: `pageRange "${pageRange}" requested; full text returned as pdf-parse extracts all pages. Use pdf-split first to isolate specific pages.` } : {}),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=pdf-extract.js.map

package/dist/tools/pdf-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-extract.js","sourceRoot":"","sources":["../../src/tools/pdf-extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,8FAA8F,EAC9F;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;KACxH,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAErB,2DAA2D;QAC3D,0DAA0D;QAC1D,4CAA4C;QAC5C,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,IAAI,EAAE;gBACJ,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;gBAC/B,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI;gBACjC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;gBACnC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;aACpC;YACD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,SAAS,iHAAiH,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzK,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/pdf-merge.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPdfMerge(server: McpServer): void;

package/dist/tools/pdf-merge.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import { PDFDocument } from 'pdf-lib';
+export function registerPdfMerge(server) {
+    server.tool('pdf-merge', 'Merge multiple PDF files into a single PDF. Provide an array of file paths and an output path.', {
+        inputFiles: z.array(z.string()).min(2).describe('Array of absolute paths to PDF files to merge (minimum 2)'),
+        outputPath: z.string().describe('Absolute path for the merged output PDF'),
+    }, async ({ inputFiles, outputPath }) => {
+        const mergedPdf = await PDFDocument.create();
+        for (const filePath of inputFiles) {
+            const bytes = await fs.readFile(filePath);
+            const sourcePdf = await PDFDocument.load(bytes);
+            const pages = await mergedPdf.copyPages(sourcePdf, sourcePdf.getPageIndices());
+            for (const page of pages) {
+                mergedPdf.addPage(page);
+            }
+        }
+        const mergedBytes = await mergedPdf.save();
+        await fs.writeFile(outputPath, mergedBytes);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        outputPath,
+                        totalPages: mergedPdf.getPageCount(),
+                        mergedFiles: inputFiles.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=pdf-merge.js.map

package/dist/tools/pdf-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-merge.js","sourceRoot":"","sources":["../../src/tools/pdf-merge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,gGAAgG,EAChG;QACE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QAC5G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC3E,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAE7C,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;YAC/E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAE5C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,UAAU;wBACV,UAAU,EAAE,SAAS,CAAC,YAAY,EAAE;wBACpC,WAAW,EAAE,UAAU,CAAC,MAAM;qBAC/B,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/pdf-split.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPdfSplit(server: McpServer): void;

package/dist/tools/pdf-split.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import fs from 'fs/promises';
+import { PDFDocument } from 'pdf-lib';
+function parsePageRange(range, totalPages) {
+    const pages = [];
+    const parts = range.split(',').map((s) => s.trim());
+    for (const part of parts) {
+        if (part.includes('-')) {
+            const [startStr, endStr] = part.split('-');
+            const start = Math.max(1, parseInt(startStr, 10));
+            const end = Math.min(totalPages, parseInt(endStr, 10));
+            for (let i = start; i <= end; i++) {
+                pages.push(i - 1); // 0-indexed
+            }
+        }
+        else {
+            const pageNum = parseInt(part, 10);
+            if (pageNum >= 1 && pageNum <= totalPages) {
+                pages.push(pageNum - 1);
+            }
+        }
+    }
+    return [...new Set(pages)].sort((a, b) => a - b);
+}
+export function registerPdfSplit(server) {
+    server.tool('pdf-split', 'Split a PDF file by extracting specific pages into a new PDF. Supports page ranges like "1-3", "5", or "1,3,5-7".', {
+        inputFile: z.string().describe('Absolute path to the source PDF file'),
+        pageRange: z.string().describe('Pages to extract: e.g. "1-3", "5", "1,3,5-7"'),
+        outputPath: z.string().describe('Absolute path for the output PDF'),
+    }, async ({ inputFile, pageRange, outputPath }) => {
+        const bytes = await fs.readFile(inputFile);
+        const sourcePdf = await PDFDocument.load(bytes);
+        const totalPages = sourcePdf.getPageCount();
+        const pageIndices = parsePageRange(pageRange, totalPages);
+        if (pageIndices.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `No valid pages in range "${pageRange}". PDF has ${totalPages} pages.` }),
+                    }],
+            };
+        }
+        const newPdf = await PDFDocument.create();
+        const copiedPages = await newPdf.copyPages(sourcePdf, pageIndices);
+        for (const page of copiedPages) {
+            newPdf.addPage(page);
+        }
+        const newBytes = await newPdf.save();
+        await fs.writeFile(outputPath, newBytes);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        outputPath,
+                        extractedPages: pageIndices.map((i) => i + 1),
+                        totalSourcePages: totalPages,
+                        outputPageCount: newPdf.getPageCount(),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=pdf-split.js.map

package/dist/tools/pdf-split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-split.js","sourceRoot":"","sources":["../../src/tools/pdf-split.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "mcp-server-docpipe",
+  "version": "1.0.0",
+  "description": "MCP server for document processing - PDF extract/merge/split, DOCX to Markdown, image resize/compress",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-server-docpipe": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": ["mcp", "claude", "pdf", "docx", "image", "document-processing", "ai-tools"],
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "mammoth": "^1.12.0",
+    "pdf-lib": "^1.17.1",
+    "pdf-parse": "^1.1.1",
+    "sharp": "^0.33.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * mcp-server-docpipe
+ * MCP server for document processing:
+ * - PDF text extraction, merge, split
+ * - DOCX to Markdown conversion
+ * - Image resize and compression
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerPdfTools } from './tools/pdf-extract.js';
+import { registerPdfMerge } from './tools/pdf-merge.js';
+import { registerPdfSplit } from './tools/pdf-split.js';
+import { registerDocxConvert } from './tools/docx-convert.js';
+import { registerImageTools } from './tools/image-process.js';
+
+const server = new McpServer({
+  name: 'mcp-server-docpipe',
+  version: '1.0.0',
+});
+
+// Register all tools
+registerPdfTools(server);
+registerPdfMerge(server);
+registerPdfSplit(server);
+registerDocxConvert(server);
+registerImageTools(server);
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('mcp-server-docpipe started on stdio');
+}
+
+main().catch((error) => {
+  console.error('Server failed to start:', error);
+  process.exit(1);
+});

package/src/tools/docx-convert.ts

@@ -0,0 +1,72 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import fs from 'fs/promises';
+import * as mammoth from 'mammoth';
+
+export function registerDocxConvert(server: McpServer) {
+  server.tool(
+    'docx-to-markdown',
+    'Convert a DOCX (Word) file to Markdown format. Preserves headings, lists, bold/italic, tables, and links.',
+    {
+      filePath: z.string().describe('Absolute path to the DOCX file'),
+      outputPath: z.string().optional().describe('Optional: save Markdown to this path. If omitted, returns content directly.'),
+    },
+    async ({ filePath, outputPath }) => {
+      const buffer = await fs.readFile(filePath);
+      const result = await mammoth.convertToMarkdown({ buffer });
+
+      const markdown = result.value;
+      const warnings = result.messages
+        .filter((m) => m.type === 'warning')
+        .map((m) => m.message);
+
+      if (outputPath) {
+        await fs.writeFile(outputPath, markdown, 'utf-8');
+      }
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            success: true,
+            markdown: outputPath ? `(saved to ${outputPath})` : markdown,
+            characterCount: markdown.length,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            ...(outputPath ? { outputPath } : {}),
+          }, null, 2),
+        }],
+      };
+    }
+  );
+
+  server.tool(
+    'docx-to-html',
+    'Convert a DOCX (Word) file to HTML format.',
+    {
+      filePath: z.string().describe('Absolute path to the DOCX file'),
+      outputPath: z.string().optional().describe('Optional: save HTML to this path'),
+    },
+    async ({ filePath, outputPath }) => {
+      const buffer = await fs.readFile(filePath);
+      const result = await mammoth.convertToHtml({ buffer });
+
+      const html = result.value;
+
+      if (outputPath) {
+        await fs.writeFile(outputPath, html, 'utf-8');
+      }
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            success: true,
+            html: outputPath ? `(saved to ${outputPath})` : html,
+            characterCount: html.length,
+            ...(outputPath ? { outputPath } : {}),
+          }, null, 2),
+        }],
+      };
+    }
+  );
+}

package/src/tools/image-process.ts

@@ -0,0 +1,133 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import fs from 'fs/promises';
+import sharp from 'sharp';
+import path from 'path';
+
+export function registerImageTools(server: McpServer) {
+  server.tool(
+    'image-resize',
+    'Resize an image to specified dimensions. Supports JPEG, PNG, WebP, AVIF, TIFF, GIF.',
+    {
+      inputFile: z.string().describe('Absolute path to the source image'),
+      outputPath: z.string().describe('Absolute path for the resized output image'),
+      width: z.number().int().positive().optional().describe('Target width in pixels'),
+      height: z.number().int().positive().optional().describe('Target height in pixels'),
+      fit: z.enum(['cover', 'contain', 'fill', 'inside', 'outside']).optional().default('inside')
+        .describe('How to fit: cover (crop), contain (letterbox), fill (stretch), inside (max dimensions), outside (min dimensions)'),
+    },
+    async ({ inputFile, outputPath, width, height, fit }) => {
+      if (!width && !height) {
+        return {
+          content: [{
+            type: 'text' as const,
+            text: JSON.stringify({ error: 'At least one of width or height must be specified' }),
+          }],
+        };
+      }
+
+      const info = await sharp(inputFile)
+        .resize({ width: width ?? undefined, height: height ?? undefined, fit })
+        .toFile(outputPath);
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            success: true,
+            outputPath,
+            output: {
+              width: info.width,
+              height: info.height,
+              format: info.format,
+              size: info.size,
+            },
+          }, null, 2),
+        }],
+      };
+    }
+  );
+
+  server.tool(
+    'image-compress',
+    'Compress and/or convert an image to a different format (WebP, AVIF, JPEG, PNG). Great for reducing file size.',
+    {
+      inputFile: z.string().describe('Absolute path to the source image'),
+      outputPath: z.string().describe('Absolute path for the compressed output image'),
+      format: z.enum(['webp', 'avif', 'jpeg', 'png']).describe('Output format'),
+      quality: z.number().int().min(1).max(100).optional().default(80)
+        .describe('Compression quality 1-100 (lower = smaller file, default 80)'),
+    },
+    async ({ inputFile, outputPath, format, quality }) => {
+      const inputStat = await fs.stat(inputFile);
+      let pipeline = sharp(inputFile);
+
+      switch (format) {
+        case 'webp':
+          pipeline = pipeline.webp({ quality });
+          break;
+        case 'avif':
+          pipeline = pipeline.avif({ quality });
+          break;
+        case 'jpeg':
+          pipeline = pipeline.jpeg({ quality });
+          break;
+        case 'png':
+          pipeline = pipeline.png({ quality });
+          break;
+      }
+
+      const info = await pipeline.toFile(outputPath);
+      const outputStat = await fs.stat(outputPath);
+
+      const compressionRatio = ((1 - outputStat.size / inputStat.size) * 100).toFixed(1);
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            success: true,
+            outputPath,
+            inputSize: inputStat.size,
+            outputSize: outputStat.size,
+            compressionRatio: `${compressionRatio}%`,
+            output: {
+              width: info.width,
+              height: info.height,
+              format: info.format,
+            },
+          }, null, 2),
+        }],
+      };
+    }
+  );
+
+  server.tool(
+    'image-info',
+    'Get metadata and dimensions of an image file without modifying it.',
+    {
+      filePath: z.string().describe('Absolute path to the image file'),
+    },
+    async ({ filePath }) => {
+      const metadata = await sharp(filePath).metadata();
+      const stat = await fs.stat(filePath);
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            filePath,
+            width: metadata.width,
+            height: metadata.height,
+            format: metadata.format,
+            space: metadata.space,
+            channels: metadata.channels,
+            hasAlpha: metadata.hasAlpha,
+            fileSize: stat.size,
+            density: metadata.density,
+          }, null, 2),
+        }],
+      };
+    }
+  );
+}

package/src/tools/pdf-extract.ts

@@ -0,0 +1,45 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import fs from 'fs/promises';
+import pdfParse from 'pdf-parse';
+
+export function registerPdfTools(server: McpServer) {
+  server.tool(
+    'pdf-extract-text',
+    'Extract text content from a PDF file. Returns the full text and metadata (page count, info).',
+    {
+      filePath: z.string().describe('Absolute path to the PDF file'),
+      pageRange: z.string().optional().describe('Page range to extract, e.g. "1-5" or "3" (optional, defaults to all pages)'),
+    },
+    async ({ filePath, pageRange }) => {
+      const buffer = await fs.readFile(filePath);
+      const data = await pdfParse(buffer);
+
+      let text = data.text;
+
+      // If pageRange is specified, we extract from the full text
+      // pdf-parse doesn't support per-page extraction natively,
+      // so we provide the full text with metadata
+      const result = {
+        text: text.trim(),
+        pageCount: data.numpages,
+        info: {
+          title: data.info?.Title || null,
+          author: data.info?.Author || null,
+          subject: data.info?.Subject || null,
+          creator: data.info?.Creator || null,
+        },
+        ...(pageRange ? { note: `pageRange "${pageRange}" requested; full text returned as pdf-parse extracts all pages. Use pdf-split first to isolate specific pages.` } : {}),
+      };
+
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    }
+  );
+}

package/src/tools/pdf-merge.ts

@@ -0,0 +1,44 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import fs from 'fs/promises';
+import { PDFDocument } from 'pdf-lib';
+
+export function registerPdfMerge(server: McpServer) {
+  server.tool(
+    'pdf-merge',
+    'Merge multiple PDF files into a single PDF. Provide an array of file paths and an output path.',
+    {
+      inputFiles: z.array(z.string()).min(2).describe('Array of absolute paths to PDF files to merge (minimum 2)'),
+      outputPath: z.string().describe('Absolute path for the merged output PDF'),
+    },
+    async ({ inputFiles, outputPath }) => {
+      const mergedPdf = await PDFDocument.create();
+
+      for (const filePath of inputFiles) {
+        const bytes = await fs.readFile(filePath);
+        const sourcePdf = await PDFDocument.load(bytes);
+        const pages = await mergedPdf.copyPages(sourcePdf, sourcePdf.getPageIndices());
+        for (const page of pages) {
+          mergedPdf.addPage(page);
+        }
+      }
+
+      const mergedBytes = await mergedPdf.save();
+      await fs.writeFile(outputPath, mergedBytes);
+
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify({
+              success: true,
+              outputPath,
+              totalPages: mergedPdf.getPageCount(),
+              mergedFiles: inputFiles.length,
+            }, null, 2),
+          },
+        ],
+      };
+    }
+  );
+}

package/src/tools/pdf-split.ts

@@ -0,0 +1,78 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import fs from 'fs/promises';
+import path from 'path';
+import { PDFDocument } from 'pdf-lib';
+
+function parsePageRange(range: string, totalPages: number): number[] {
+  const pages: number[] = [];
+  const parts = range.split(',').map((s) => s.trim());
+
+  for (const part of parts) {
+    if (part.includes('-')) {
+      const [startStr, endStr] = part.split('-');
+      const start = Math.max(1, parseInt(startStr, 10));
+      const end = Math.min(totalPages, parseInt(endStr, 10));
+      for (let i = start; i <= end; i++) {
+        pages.push(i - 1); // 0-indexed
+      }
+    } else {
+      const pageNum = parseInt(part, 10);
+      if (pageNum >= 1 && pageNum <= totalPages) {
+        pages.push(pageNum - 1);
+      }
+    }
+  }
+
+  return [...new Set(pages)].sort((a, b) => a - b);
+}
+
+export function registerPdfSplit(server: McpServer) {
+  server.tool(
+    'pdf-split',
+    'Split a PDF file by extracting specific pages into a new PDF. Supports page ranges like "1-3", "5", or "1,3,5-7".',
+    {
+      inputFile: z.string().describe('Absolute path to the source PDF file'),
+      pageRange: z.string().describe('Pages to extract: e.g. "1-3", "5", "1,3,5-7"'),
+      outputPath: z.string().describe('Absolute path for the output PDF'),
+    },
+    async ({ inputFile, pageRange, outputPath }) => {
+      const bytes = await fs.readFile(inputFile);
+      const sourcePdf = await PDFDocument.load(bytes);
+      const totalPages = sourcePdf.getPageCount();
+
+      const pageIndices = parsePageRange(pageRange, totalPages);
+
+      if (pageIndices.length === 0) {
+        return {
+          content: [{
+            type: 'text' as const,
+            text: JSON.stringify({ error: `No valid pages in range "${pageRange}". PDF has ${totalPages} pages.` }),
+          }],
+        };
+      }
+
+      const newPdf = await PDFDocument.create();
+      const copiedPages = await newPdf.copyPages(sourcePdf, pageIndices);
+      for (const page of copiedPages) {
+        newPdf.addPage(page);
+      }
+
+      const newBytes = await newPdf.save();
+      await fs.writeFile(outputPath, newBytes);
+
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            success: true,
+            outputPath,
+            extractedPages: pageIndices.map((i) => i + 1),
+            totalSourcePages: totalPages,
+            outputPageCount: newPdf.getPageCount(),
+          }, null, 2),
+        }],
+      };
+    }
+  );
+}

package/src/types.d.ts

@@ -0,0 +1,41 @@
+declare module 'pdf-parse' {
+  interface PDFInfo {
+    Title?: string;
+    Author?: string;
+    Subject?: string;
+    Creator?: string;
+    [key: string]: unknown;
+  }
+
+  interface PDFData {
+    numpages: number;
+    numrender: number;
+    info: PDFInfo;
+    metadata: unknown;
+    text: string;
+    version: string;
+  }
+
+  function pdfParse(buffer: Buffer): Promise<PDFData>;
+  export = pdfParse;
+}
+
+declare module 'mammoth' {
+  interface ConversionMessage {
+    type: string;
+    message: string;
+  }
+
+  interface ConversionResult {
+    value: string;
+    messages: ConversionMessage[];
+  }
+
+  interface ConvertOptions {
+    buffer: Buffer;
+  }
+
+  export function convertToHtml(options: ConvertOptions): Promise<ConversionResult>;
+  export function convertToMarkdown(options: ConvertOptions): Promise<ConversionResult>;
+  export function extractRawText(options: ConvertOptions): Promise<ConversionResult>;
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}