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 集成