shuck-convert

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

Metadata

Release files for shuck-convert 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for shuck-convert 1.0.0
File	Size	Uploaded
shuck_convert-1.0.0.tar.gz	9.9 kB	Apr 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for shuck-convert 1.0.0
File	Interpreter	ABI	Platform	Reset
shuck_convert-1.0.0-py3-none-any.whl 12.1 kB Apr 17, 2026	Python 3	none	any	Details

Total release size: 22.0 kB

Release files / shuck_convert-1.0.0.tar.gz

Download URL	shuck_convert-1.0.0.tar.gz
Size	9.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`f78b2e63be64fccd78b03ee44f964704eb60f16fd628e8d4c40dacda6be52e68`
BLAKE2b-256 checksum How to use checksums	`89c320b14d38cfa41979ba0b31500f6b2b445a7744cd387cfcec2b9d103fc200`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.3`

Release files / shuck_convert-1.0.0-py3-none-any.whl

Download URL	shuck_convert-1.0.0-py3-none-any.whl
Size	12.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e0b157527d23aa1493537f848be9e4466cfeb65d2e49d92cf6c183a2db1f4376`
BLAKE2b-256 checksum How to use checksums	`f4967c96d8db223308598d628390807e50409f24ae89d49d3d6f9d2ca8fbf9bb`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.3`

Release history Release notifications | RSS feed

This release

1.0.0 This release

Apr 17, 2026 2 release files

shuck-convert 1.0.0