io.github.Shan-Zhu/shuck-convert

shuck-convert

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

1 2 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 74d ago

Works with most clients

Transport: stdio, http

2 tools · ~107 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Writing Developer Tools

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)](https://mcppedia.org/s/io-github-shan-zhu-shuck-convert)

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

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked shuck-convert against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~107 tokens total

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.
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 can io.github.Shan-Zhu/shuck-convert do?: io.github.Shan-Zhu/shuck-convert provides 2 tools: doc_to_markdown, markdown_to_docx. See the full tools list on the server page for descriptions and parameters.
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 recently maintained — last commit was 74 days ago. It has 1 GitHub stars.

Similar servers

Others in writing / developer-tools

View all →

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0k 2

Context797

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

58.3k 2

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

6.0k 1

Jscpd97

Copy/paste detector for programming source code, supports 223 formats. AI-ready with token-efficient reporter, skill and MCP server.

5.8k 1

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.

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 can io.github.Shan-Zhu/shuck-convert do?

io.github.Shan-Zhu/shuck-convert provides 2 tools: doc_to_markdown, markdown_to_docx. See the full tools list on the server page for descriptions and parameters.

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 recently maintained — last commit was 74 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