io.github.Shan-Zhu/shuck-convert

Official

by Shan-Zhu · Python

shuck-convert

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

Convert documents between DOCX, PDF, and Markdown formats.

shuck-convert

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

An MCP server for AI agents, with CLI support.

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

bash

pip install shuck-convert

Or from source:

bash

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

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

bash

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

# Markdown to DOCX
shuck-convert md2docx paper.md

bash

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

MIT

claude_desktop_config.json

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