π¦
shuck-convert
Convert between document formats β DOCX/PDF to Markdown, Markdown to DOCX.
0 installs
Trust: 37 β Low
Files
Ask AI about shuck-convert
Powered by Claude Β· Grounded in docs
I know everything about shuck-convert. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
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
