Shuck Convert

shuck-convert

[](https://pypi.org/project/shuck-convert/) [](https://registry.modelcontextprotocol.io)

Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

An MCP server for AI agents, with CLI support.

Tools

| 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 |

Prerequisites

• Python 3.10+
• Pandoc (required for markdown_to_docx)

Install

pip install shuck-convert

Or from source:

git clone https://github.com/Shan-Zhu/shuck-convert.git
cd shuck-convert
pip install -e .

Usage

MCP Server (for AI agents)

Add to your MCP client config:

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

Or with uvx:

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

CLI

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

# Markdown to DOCX
shuck-convert md2docx paper.md

Development

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

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Shan-Zhu
• Source: Shan-Zhu/shuck-convert
• License: MIT

Install and usage instructions live in the source repository linked above.