shuck-convert
Converts between DOCX/PDF and Markdown, and Markdown to DOCX with academic styling.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shuck-convertconvert my paper.md to a formatted DOCX"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| DOCX/PDF → MD | Extract text, formatting, tables, images |
| MD → DOCX | Academic styling: Times New Roman + SimSun, three-line tables |
Related MCP server: markdown2pdf-mcp
Prerequisites
Python 3.10+
Pandoc (required for
markdown_to_docx)
Install
pip install shuck-convertOr 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.mdDevelopment
pip install -e .
fastmcp dev src/shuck_convert/server.pyLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Generate PDF, Word (.docx) and PowerPoint (.pptx) documents from Markdown over MCP.
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, PDF, DOCX (.docx), csv and more.1581MIT
- AlicenseAqualityBmaintenanceAn MCP server for converting Markdown documents to PDF files.115 npm36MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for converting various file formats (PDF, DOCX, images, audio, etc.) to Markdown using Microsoft MarkItDown, with support for large files and Cyrillic text.1MIT
- AlicenseNot gradedqualityCmaintenanceA production-ready MCP server for converting documents and files to Markdown using Microsoft MarkItDown.MIT