# Shuck Convert

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-shan-zhu-shuck-convert`
- **Verified:** Pending review
- **Seller:** [Shan-Zhu](https://agentstack.voostack.com/s/shan-zhu)
- **Installs:** 0
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [Shan-Zhu](https://github.com/Shan-Zhu)
- **Source:** https://github.com/Shan-Zhu/shuck-convert

## Install

```sh
agentstack add mcp-shan-zhu-shuck-convert
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# shuck-convert

[](https://pypi.org/project/shuck-convert/)
[](https://registry.modelcontextprotocol.io)

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](https://pandoc.org/installing.html) (required for `markdown_to_docx`)

## Install

```bash
pip install shuck-convert
```

Or from source:

```bash
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:

```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 Markdown
shuck-convert doc2md report.docx
shuck-convert doc2md paper.pdf

# Markdown to DOCX
shuck-convert md2docx paper.md
```

### Development

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

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Shan-Zhu](https://github.com/Shan-Zhu)
- **Source:** [Shan-Zhu/shuck-convert](https://github.com/Shan-Zhu/shuck-convert)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.0** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shan-zhu-shuck-convert
- Seller: https://agentstack.voostack.com/s/shan-zhu
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.