MCP Document Converter

mcp-server-convert

轻量级的 Model Context Protocol (MCP) 服务，可将文档转换为 Markdown。支持 PDF、DOCX、HTML、EPUB、CSV、JSON 和纯文本文件。

非常适合需要读取并理解文档内容的 AI Agent。

功能

• 📄 支持多种格式：PDF、DOCX、HTML、EPUB、CSV、JSON、图像（通过 OCR）和纯文本
• 🔧 6 个 MCP 工具：convert_file、convert_url、list_supported_formats、batch_convert、extract_metadata、convert_directory
• 🐍 核心功能零外部依赖：使用 Python 标准库和用于 HTML 的 markdownify
• ⚡ 速度快：在内存中处理，无需临时文件
• 🐳 可用于 Docker：单个 Dockerfile，一条命令即可部署

快速开始

安装并运行

# Clone
git clone https://github.com/demo112/mcp-server-convert.git
cd mcp-server-convert

# Install dependencies
pip install -r requirements.txt

# Run
python -m mcp_server_convert

在 Claude Code 中配置

将以下内容添加到 MCP 设置（~/.claude/settings.json）：

{
  "mcpServers": {
    "convert": {
      "command": "python",
      "args": ["-m", "mcp_server_convert"],
      "cwd": "/path/to/mcp-server-convert"
    }
  }
}

Docker

docker build -t mcp-server-convert .
docker run -i --rm mcp-server-convert

使用 Docker 配置

{
  "mcpServers": {
    "convert": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/files:/data", "mcp-server-convert"]
    }
  }
}

工具

convert_file

将本地文件转换为 Markdown。

参数：

• file_path（字符串，必填）：文件的绝对路径
• max_length（整数，可选）：输出的最大字符数（默认值：50000）

convert_url

获取 URL 并将其内容转换为 Markdown。

参数：

• url（字符串，必填）：要获取并转换的 URL
• max_length（整数，可选）：输出的最大字符数（默认值：50000）

batch_convert

一次转换多个文件。

参数：

• file_paths（字符串数组，必填）：文件路径列表
• max_length_per_file（整数，可选）：每个文件的最大长度（默认值：50000）

convert_directory

转换目录中的所有受支持文件。

参数：

• dir_path（字符串，必填）：目录路径
• recursive（布尔值，可选）：是否包含子目录（默认值：true）
• max_files（整数，可选）：要转换的最大文件数（默认值：20）

extract_metadata

从文件中提取元数据，而不进行完整转换。

参数：

• file_path（字符串，必填）：文件路径

list_supported_formats

列出所有受支持的文件扩展名及其转换方法。

支持的格式

格式	扩展名	方法
PDF	.pdf	PyMuPDF (fitz)
Word	.docx	python-docx
HTML	.html、.htm	markdownify
EPUB	.epub	ebooklib
CSV	.csv	pandas → Markdown 表格
JSON	.json	格式化的 Markdown 代码块
XML	.xml	xmltodict → Markdown
Excel	.xlsx	openpyxl → Markdown 表格
PowerPoint	.pptx	python-pptx → Markdown 幻灯片
文本	.txt、.md、.rst、.log	直接传递
图像	.png、.jpg	pytesseract OCR（如果可用）

支持

如果此工具对你的工作流有帮助，可以考虑支持其开发：

• GitHub Sponsors：通过 Liberapay 赞助
• ETH：0xddD9f45e14c92846f47C1c1A4431aC2b41D87273

许可证

MIT