1. Conduid
  2. Files
  3. shuck-convert
MCP server · Files

shuck-convert

by · github.com/Shan-Zhu/shuck-convert

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

Unclaimed last commit 6 months ago files
InstallView source
37Low

Scored 6 months ago · breakdown

About shuck-convert

shuck-convert is an MCP server published by Shan-Zhu in the Files category: convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.

The repository has 1 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

uvx
uvx shuck-convert
pip
pip install shuck-convert

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (2)

doc_to_markdownDOCX/PDF → MD

Parameters not published.

markdown_to_docxMD → DOCX

Parameters not published.

Ask AI

✦

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.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

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

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About shuck-convert

How do I install shuck-convert?

Run uvx shuck-convert, then add the server to your MCP client's configuration.

Is shuck-convert safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is shuck-convert still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.