shuck-convert

io.github.Shan-ZhuPublished by GitHub account Shan-Zhuv1.0.0Updated Oct 24, 2026

Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

The publisher's own server: convert.express

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Local MCP server that converts DOCX and PDF files to Markdown and Markdown back to DOCX, with CLI support.

What you can do
  • Convert DOCX or PDF documents into Markdown, extracting text, formatting, tables and images
  • Convert Markdown into DOCX with academic styling such as Times New Roman plus SimSun fonts and three-line tables
  • Run the same conversions from a command line as well as from an MCP client
When to use it
Useful when an assistant needs to read Word or PDF documents as Markdown, or turn Markdown notes or drafts into a formatted Word file, for example for academic-style papers.
Requirements
Runs as a local Python package (pip install shuck-convert or uvx) over stdio; needs Python 3.10+ and Pandoc installed for Markdown to DOCX conversion. No accounts, keys or environment variables are declared.
Before you install
It reads and writes document files on the local machine, so point it only at files you are willing to have processed and check where output files are written. No credentials or network access are declared.

Installation

In SourceWeft

  1. Open shuck-convert in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
pip install shuck-convert

Or from source:

bash
git clone https://github.com/Shan-Zhu/shuck-convert.gitcd shuck-convertpip install -e .

Usage

MCP Server (for AI agents)

Add to your MCP client config:

json
{  "mcpServers": {    "shuck-convert": {      "command": "shuck-convert",      "args": [],      "transportType": "stdio"    }  }}

Or with uvx:

json
{  "mcpServers": {    "shuck-convert": {      "command": "uvx",      "args": ["shuck-convert"],      "transportType": "stdio"    }  }}

CLI

bash
# DOCX/PDF to Markdownshuck-convert doc2md report.docxshuck-convert doc2md paper.pdf
# Markdown to DOCXshuck-convert md2docx paper.md

Development

bash
pip install -e .fastmcp dev src/shuck_convert/server.py

License

MIT

Source: README.md at commit 906ffd5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Convert integrations

convert.express

express.convertOfficial publisher

convert.express's hosted MCP server, published by convert.express; no sign-in required; Streamable HTTP; 14 tools.

Streamable HTTPWeb executable
Media & Design14 toolsOct 26, 2026

Decant: convert CSV, XLSX and PDF to JSON; web page extraction that honours robots.txt

com.forevenza.services

Hosted MCP server that converts CSV, XLSX and text PDFs into JSON, from private uploads or URLs, with no API key.

Streamable HTTPWeb executable
Web Search & ScrapingNot indexed yetNov 7, 2026

Unit Convert Mcp

Published by GitHub account mrfentmen

Offline unit converter MCP server that lets an assistant convert values across 100+ units and list supported categories and units.

STDIODesktop only
Developer Tools2 toolsNov 3, 2026

Jam Jam

org.jam-jam

Jam Jam converts audio, PDFs, photos and text into chord sheets and lets an assistant manage a Jam Jam songbook, playlists, stems and mastering.

STDIODesktop only
Productivity & Workflow42 toolsOct 30, 2026

Korean Address to English — Convert & Validate (주소 영문)

Published by GitHub account kr-data-api

Converts Korean addresses to official English form (road address, postal code, romanized unit) and validates them against a government database.

Streamable HTTPWeb executableAuth
Location & LifestyleCredential requiredOct 24, 2026