shuck-convert

io.github.Shan-Zhu由 GitHub 帳號 Shan-Zhu 發布v1.0.0更新於 Oct 24, 2026

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

發布方自己的服務:convert.express

已驗證STDIO僅桌面效率與工作流檔案與儲存

概覽

AI 產生的概覽

本機 MCP 伺服器,可在 DOCX、PDF 與 Markdown 之間轉換文件,並提供命令列用法。

可以做什麼
  • 將 DOCX 或 PDF 文件轉換為 Markdown,擷取文字、格式、表格與圖片
  • 將 Markdown 轉換為 DOCX,採用學術排版樣式,如 Times New Roman 加新細明體與三線表
  • 除 MCP 用戶端外,也可透過命令列執行相同的轉換
適用情境
適合需要讓助理把 Word 或 PDF 文件讀成 Markdown,或把 Markdown 草稿轉成排版好的 Word 檔案(例如學術論文格式)的情境。
執行需求
以本機 Python 套件形式透過 stdio 執行(pip install shuck-convert 或 uvx);需要 Python 3.10+,Markdown 轉 DOCX 還需安裝 Pandoc。未宣告帳號、金鑰或環境變數。
安裝前請注意
它會讀寫本機上的文件檔案,請只對願意被處理的檔案使用,並留意輸出檔案寫入的位置。未宣告任何憑證或網路存取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 shuck-convert,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

ToolDirectionDescription
doc_to_markdownDOCX/PDF → MDExtract text, formatting, tables, images
markdown_to_docxMD → DOCXAcademic styling: Times New Roman + SimSun, three-line tables

Prerequisites

  • Python 3.10+
  • Pandoc (required for markdown_to_docx)

Install

bash
pip install shuck-convert

Or from source:

bash
git clone https://github.com/Shan-Zhu/shuck-convert.gitcd shuck-convertpip 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 Markdownshuck-convert doc2md report.docxshuck-convert doc2md paper.pdf
# Markdown to DOCXshuck-convert md2docx paper.md

Development

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

License

MIT

來源:README.md,提交 906ffd5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Convert 整合