shan-zhu avatar

shuck-convert

shan-zhu/shuck-convert

This server gives Claude two document conversion tools: doc_to_markdown pulls text, formatting, tables, and images from DOCX or PDF files into Markdown, while markdown_to_docx goes the other direction with opinionated academic styling (Times New Roman, SimSun, three-line tables). It's built on Pandoc for the Markdown to DOCX direction, so you'll need that installed. Reach for this when you want Claude to extract content from uploaded documents for analysis or rewriting, or when you need to generate formatted Word documents from Markdown that Claude produces. Also ships as a standalone CLI if you want to use it outside the MCP context.

GitHub stars
1
tools
2
transport
STDIO
last updated
Apr 17, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

doc_to_markdownExtract text, formatting, tables, images

Extract text, formatting, tables, images

No parameter schema in public metadata yet.

markdown_to_docxAcademic styling: Times New Roman + SimSun, three-line tables

Academic styling: Times New Roman + SimSun, three-line tables

No parameter schema in public metadata yet.

Sponsors

Readme

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

ToolDirectionDescription
doc_to_markdownDOCX/PDF → MDExtract text, formatting, tables, images
markdown_to_docxMD → DOCXAcademic 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:


View the full README on GitHub

Details

Repository
github.com/shan-zhu/shuck-convert
Category
Documents & Knowledge
Package
shuck-convert
Transport
STDIO
Registry
MCP registry, active

More from shan-zhu

Related Documents & Knowledge MCP servers

View all
1adelaidasofia avatarFastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge gadelaidasofia/graph-autotagger-mcpFastMCP server for Obsidian wikilink suggestions from a pre-computed knowledge graph (graphify…0stars
2auteng avatarAutEng Docs — Agent Document Workspace & Publishingai.auteng/docsAgent document workspace with wallet auth. Create, update and share markdown docs. By AutEng.ai0stars
3caravaca-labs avatarPageTranslatecaravaca-labs/pagetranslate-mcpTranslate PDF, scanned PDF, DOCX and EPUB files into 70+ languages with the layout kept.0stars
4prince avatarPrince Cloudcloud.prince/princeConvert Markdown, HTML, and web pages to high-quality PDF with Prince.0stars
5hjarni avatarHjarnihjarni/hjarni-mcpMarkdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.0stars
6spocont avatarDocu-Scan MCPcom.spocont/docu-scanPDF and document extraction via Google Document AI. Free trial available.0stars