pdf-to-md-mcp
MCP Server for high-quality PDF to Markdown conversion. Powered by pymupdf4llm.
高质量 PDF 转 Markdown 的 MCP Server，基于 pymupdf4llm。
Features / 功能
- Heading hierarchy preservation (
#,##,###) / 保留标题层级结构 - Markdown table extraction / 提取 Markdown 格式表格
- Image extraction to local files / 提取图片到本地文件
- List structure preservation / 保留列表结构
- Works with any MCP client (Kiro, Claude Desktop, Cursor, etc.) / 兼容所有 MCP 客户端
Quick Start / 快速开始
Using uvx (recommended / 推荐)
No installation needed / 无需安装：
{
"mcpServers": {
"pdf-to-md": {
"command": "uvx",
"args": ["pdf-to-md-mcp"]
}
}
}
Using pip
pip install pdf-to-md-mcp
Then configure your MCP client / 然后配置你的 MCP 客户端：
{
"mcpServers": {
"pdf-to-md": {
"command": "pdf-to-md-mcp"
}
}
}
Tool: pdf_to_markdown
| Parameter / 参数 | Type / 类型 | Default / 默认值 | Description / 说明 |
|---|---|---|---|
pdf_path |
string | (required / 必填) | Path to the PDF file / PDF 文件路径 |
output_path |
string | "" |
Output Markdown file path. Empty = return content only / 输出路径，为空则只返回内容 |
extract_images |
boolean | true |
Extract images to local images/ directory / 是否提取图片到本地 |
Example / 示例
Convert test/sample.pdf to Markdown and save to docs/output.md
把 test/sample.pdf 转成 Markdown 保存到 docs/output.md
Images will be saved to docs/images/.
图片会保存到 docs/images/ 目录。
License / 许可证
MIT
1 maintainer
Metadata
1 maintainer
Release files for pdf-to-md-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pdf_to_md_mcp-0.1.0.tar.gz | 4.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pdf_to_md_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.0 kB
Release files / pdf_to_md_mcp-0.1.0.tar.gz
| Download URL | pdf_to_md_mcp-0.1.0.tar.gz |
|---|---|
| Size | 4.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ecca30169c45571e010304ec46d9286dc1b3970cb5601f614f0ca77301d6ae8a
|
|
BLAKE2b-256 checksum How to use checksums |
2b104ba1a8535ea98d77177c3f45a11661fb2908597401a243b4268a5547c69d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
Release files / pdf_to_md_mcp-0.1.0-py3-none-any.whl
| Download URL | pdf_to_md_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e5e485cecc7eab513b55d04daabebccf45b15e505d3156d1c6e3defb3818ea27
|
|
BLAKE2b-256 checksum How to use checksums |
21330a68ceed403f9171e55f0ca40db5985cd0eb057fb2ed2222e0498b0291a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
