mcpField
S
shuck-convert

shuck-convert

本地服务
github.com/Shan-Zhu生产力128 周前更新
代码仓库

关于 shuck-convert

shuck-convert 是供 AI Agent 和文档工作流使用的 MCP 服务与命令行工具，可将 DOCX、PDF 转为 Markdown，也能将 Markdown 转为 DOCX，并支持学术样式排版。

主要功能

  1. 01DOCX/PDF 转 Markdown
  2. 02提取文本、格式、表格和图片
  3. 03Markdown 转 DOCX
  4. 04学术文档样式排版
  5. 05支持命令行和 MCP 服务

适用场景

  1. 01提取报告或论文内容
  2. 02将 Markdown 论文转为样式化 DOCX
  3. 03让 AI Agent 转换文档格式

MCP 相关

向 MCP 客户端提供文档转换工具，包括 `doc_to_markdown` 和 `markdown_to_docx`。服务可通过 stdio 运行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shan-zhu-shuck-convert": {
      "command": "uvx",
      "args": [
        "shuck-convert"
      ]
    }
  }
}
启动命令uvx shuck-convert

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypishuck-convert1.0.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

shuck-convert

PyPI MCP Registry

在文档格式之间进行转换——DOCX/PDF 转 Markdown，Markdown 转 DOCX。

面向 AI Agent 的 MCP 服务，支持 CLI。

工具

工具转换方向描述
doc_to_markdownDOCX/PDF → MD提取文本、格式、表格和图像
markdown_to_docxMD → DOCX学术风格：Times New Roman + 宋体，三线表

前置条件

  • 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 Agent）

添加到 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。