shuck-convert

shuck-convert

ドキュメント形式を相互に変換します。DOCX／PDF から Markdown へ、Markdown から DOCX へ変換できます。

AI エージェント向けの MCP サーバーで、CLI にも対応しています。

ツール

ツール	変換方向	説明
doc_to_markdown	DOCX/PDF → MD	テキスト、書式、表、画像を抽出します
markdown_to_docx	MD → DOCX	論文向けの書式設定：Times New Roman + SimSun、三線表

前提条件

• Python 3.10+
• Pandoc（markdown_to_docx に必要）

インストール

pip install shuck-convert

または、ソースからインストールします。

git clone https://github.com/Shan-Zhu/shuck-convert.git
cd shuck-convert
pip install -e .

使い方

MCP サーバー（AI エージェント向け）

MCP クライアントの設定に追加します。

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

または、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

開発

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

ライセンス

MIT