Skip to main content
Glama
Shan-Zhu

shuck-convert

by Shan-Zhu

shuck-convert

PyPI MCP Registry

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

Related MCP server: markdown2pdf-mcp

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

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers