io.github.Shan-Zhu/shuck-convert

shuck-convert

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

1 GitHub PyPI

No known CVEs

MIT license

Maintained

Last commit 128d ago

Works with most clients

Transport: stdio, http

0 tools

Grade F

MCPpedia last refreshed this data 3h ago

Edit this pageView history

io.github.Shan-Zhu/shuck-convert is an MCP server that convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX. Its tool list has not been published yet over stdio and http, requires no API key, and scores 50/100 on MCPpedia's security, maintenance and efficiency rubric.

Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shan-zhu-shuck-convert-shan-zhu)](https://mcppedia.org/s/io-github-shan-zhu-shuck-convert-shan-zhu)

Read me

What io.github.Shan-Zhu/shuck-convert does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'shuck-convert' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

50/100across 5 weighted dimensions

How we score →

0255075100

−50

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked shuck-convert against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Shan-Zhu/shuck-convert safe to use?: io.github.Shan-Zhu/shuck-convert has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.Shan-Zhu/shuck-convert?: io.github.Shan-Zhu/shuck-convert supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.Shan-Zhu/shuck-convert?: io.github.Shan-Zhu/shuck-convert is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.Shan-Zhu/shuck-convert actively maintained?: io.github.Shan-Zhu/shuck-convert is less actively maintained — last commit was 128 days ago. It has 1 GitHub stars.

Similar servers

Others in writing

View all →

Mcp Pandoc94

MCP server for document format conversion using pandoc.

576 1

Mcp Server Youtube Transcript92

This is an MCP server that allows you to directly download transcripts of YouTube videos.

583 1

io.github.xberg-io/crawlberg92

Scrape, crawl, and map websites to Markdown or JSON via local CLI.

160 5

io.github.damonwill78-a11y/clean-markdown90

Any URL to clean, LLM-ready Markdown for RAG. Strips ads, nav, and boilerplate.

MCP Security Weekly

Get CVE alerts and security updates for io.github.Shan-Zhu/shuck-convert and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

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

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

Frequently Asked Questions

Is io.github.Shan-Zhu/shuck-convert safe to use?

io.github.Shan-Zhu/shuck-convert has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install io.github.Shan-Zhu/shuck-convert?

io.github.Shan-Zhu/shuck-convert supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What AI clients work with io.github.Shan-Zhu/shuck-convert?

io.github.Shan-Zhu/shuck-convert is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is io.github.Shan-Zhu/shuck-convert actively maintained?

io.github.Shan-Zhu/shuck-convert is less actively maintained — last commit was 128 days ago. It has 1 GitHub stars.

shuck-convert

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