mcpField
S
shuck-convert

shuck-convert

Local
github.com/Shan-ZhuProductivity1Updated 28w ago
Repository

About shuck-convert

shuck-convert is an MCP server and CLI for converting DOCX and PDF documents to Markdown, and Markdown to DOCX. It is intended for AI agents and document workflows that need text, formatting, tables, and images extracted or academic styling applied.

Key features

  1. 01DOCX/PDF to Markdown conversion
  2. 02Extract text, formatting, tables, and images
  3. 03Markdown to DOCX conversion
  4. 04Academic document styling
  5. 05CLI and MCP server access

Use cases

  1. 01Extract content from reports or papers
  2. 02Convert Markdown papers into styled DOCX
  3. 03Let AI agents convert document formats

MCP support

Exposes document conversion tools to MCP clients, including `doc_to_markdown` and `markdown_to_docx`. The server can be run over stdio.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "shan-zhu-shuck-convert": {
      "command": "uvx",
      "args": [
        "shuck-convert"
      ]
    }
  }
}
Run commanduvx shuck-convert

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypishuck-convert1.0.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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:

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.