io.github.Shan-Zhu/shuck-convert MCP Server

The io.github.Shan-Zhu/shuck-convert MCP server converts between document formats, supporting DOCX/PDF to Markdown and Markdown to DOCX. It is described as an MCP server for AI agents and includes CLI support. The tooling focuses on extracting text and formatting, including tables and images.

🛠️ Key Features

Convert DOCX/PDF → Markdown
Convert Markdown → DOCX
Extract text and formatting
Handle tables and images (per tool descriptions)

🚀 Use Cases

Transform DOCX or PDF documents into Markdown for review or editing
Convert Markdown content back into DOCX documents for distribution
Maintain document structure via table and image extraction during conversion

⚡ Developer Benefits

Provides doc_to_markdown and markdown_to_docx tools for automated pipelines
Supports AI-agent usage and mentions CLI support

⚠️ Limitations

Only the formats explicitly listed (DOCX/PDF, Markdown, DOCX) are described in available data

Tool

Direction

Description

doc_to_markdown

DOCX/PDF → MD

Extract text, formatting, tables, images

markdown_to_docx

MD → DOCX

Academic styling: Times New Roman + SimSun, three-line tables

Usage

MCP Server (for AI agents)

Add to your MCP client config:

json

{
  "mcpServers": {
    "shuck-convert": {
      "command": "shuck-convert",
      "args": [],
      "transportType": "stdio"
    }
  }
}

Or with uvx:

json

{
  "mcpServers": {
    "shuck-convert": {
      "command": "uvx",
      "args": ["shuck-convert"],
      "transportType": "stdio"
    }
  }
}

CLI

bash

# DOCX/PDF to Markdown
shuck-convert doc2md report.docx
shuck-convert doc2md paper.pdf

# Markdown to DOCX
shuck-convert md2docx paper.md

Development

bash

pip install -e .
fastmcp dev src/shuck_convert/server.py

shuck-convert

io.github.Shan-Zhu/shuck-convert MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

shuck-convert

Tools

Prerequisites

Install

Usage

MCP Server (for AI agents)

CLI

Development

License

Install

Related servers