MCP 服务器

docio-mcp

Enables document conversion between 50+ formats, including Excel and PDF, using Pandoc with automatic format detection and caching.

README

Docio MCP Server

A Model Context Protocol (MCP) server that provides comprehensive document conversion capabilities using Pandoc with additional support for Excel files and modern PDF processing.

Features

Universal Document Conversion: Convert between 50+ document formats
Excel Support: Full Excel (.xlsx) file creation and conversion using pure JavaScript
Modern PDF Processing: PDF text extraction and generation using Puppeteer and pdf-parse
No External Dependencies: All format conversions work out-of-the-box
Batch Processing: Convert multiple documents simultaneously
Metadata Extraction: Extract document metadata and statistics
Document Validation: Validate document format and structure
- Plain text extraction
- Document metadata extraction
- Bulk document conversion
Smart Format Detection: Automatically detects file formats from extensions and content
Intelligent Response System: Returns file content for text formats, file paths for binary formats
Caching System: Efficient caching to avoid repeated conversions
Comprehensive Format Support:
- Documents: DOCX, DOC, ODT, RTF, PDF
- Markup: HTML, XML, LaTeX, reStructuredText
- E-books: EPUB
- Presentations: PPTX

Installation

npm install -g docio-mcp

The installation will automatically download the appropriate Pandoc binary for your platform.

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "pandoc": {
      "command": "npx",
  "args": ["docio-mcp"]
    }
  }
}

With VS Code

Add to your MCP configuration:

{
  "pandoc": {
    "command": "npx",
  "args": ["docio-mcp"]
  }
}

Available Tools

`convert_to_markdown`

Converts documents to Markdown format optimized for AI tools.

Parameters:

input (required): File content (base64 encoded) or file path
inputFormat (optional): Input format (auto-detected if not specified)
filePath (optional): Original file path for format detection
outputOptions (optional): Conversion options
- preserveFormatting (boolean): Preserve original formatting
- extractImages (boolean): Extract and include images
- tableStyle ('pipe' | 'grid' | 'simple'): Table formatting style
- mathFormat ('unicode' | 'tex' | 'mathml'): Math formula format

Example:

{
  "input": "base64encodedcontent...",
  "inputFormat": "docx",
  "outputOptions": {
    "preserveFormatting": true,
    "tableStyle": "pipe"
  }
}

`convert_document`

Universal document conversion between formats.

Parameters:

input (required): File content (base64 encoded) or file path
outputFormat (required): Target format
inputFormat (optional): Input format (auto-detected if not specified)
filePath (optional): Original file path for format detection
options (optional): Additional Pandoc options

`extract_text`

Extracts plain text from documents.

Parameters:

input (required): File content (base64 encoded) or file path
inputFormat (optional): Input format (auto-detected if not specified)
filePath (optional): Original file path for format detection

`get_document_metadata`

Extracts metadata from documents.

Parameters:

input (required): File content (base64 encoded) or file path
inputFormat (optional): Input format (auto-detected if not specified)
filePath (optional): Original file path for format detection

`list_supported_formats`

Lists all supported input and output formats.

Supported Formats

Input Formats

Documents: docx, doc, odt, rtf, pdf
Markup: html, xml, markdown, rst, latex
E-books: epub, epub3
Presentations: pptx
Web: html5, html4

Output Formats

Documents: docx, pdf, odt, rtf
Markup: markdown, html, xml, latex, rst
E-books: epub, epub3
Plain text: plain

Development

Building from Source

git clone <repository-url>
cd docio-mcp
npm install
npm run build

Running in Development

npm run dev

Project Structure

docio-mcp/
├── src/
│   ├── index.ts          # MCP server main entry
│   ├── pandoc.ts         # Pandoc wrapper and manager
│   └── utils/
│       ├── cache.ts      # Conversion caching system
│       └── file.ts       # File utilities and format detection
├── bin/                  # Pandoc binaries (auto-downloaded)
├── scripts/
│   └── download-pandoc.js # Pandoc download script
└── dist/                 # Compiled JavaScript