适合谁
- 希望将文档转换集成到 AI 代理或 MCP 客户端（如 Claude Desktop）的开发者。
- 需要将 PDF 转换为 Markdown/JSON 并用于 RAG 或知识管理的团队。
- 使用 Docling Serve 或想要混合模式（远程+本地回退）的用户。
D
50FMRS · D
Docling MCP 是一个功能丰富的文档转换服务器，支持远程和本地转换，提供广泛的工具集（转换、生成、RAG）。它适合需要将文档处理集成到 AI 代理的开发者，但配置复杂度较高，且远程模式依赖外部服务。
Docling MCP 是一个基于模型上下文协议（MCP）的文档处理服务，利用 Docling 库将 PDF 和其他文档转换为结构化格式，并提供缓存、生成、RAG 等工具。支持远程（Docling Serve）和本地（docling-mcp[local]）转换模式。
工具能力
convert_pdf_to_docling_document
将本地 PDF 文档转换为结构化 DoclingDocument 格式。
convert_pdf_to_docling_document_from_url
将远程 URL 中的 PDF 文档转换为 DoclingDocument 格式。
create_new_docling_document
创建一个新的空 DoclingDocument。
add_title_to_docling_document
向文档添加标题。
add_heading_to_docling_document
向文档添加章节标题。
add_paragraph_to_docling_document
向文档添加段落。
open_list_in_docling_document
在文档中打开一个列表。
add_listitem_to_list_in_docling_document
向打开的列表添加列表项。
close_list_in_docling_document
关闭当前打开的列表。
add_table_to_docling_document
向文档添加表格。
export_docling_document_to_markdown
将文档导出为 Markdown 格式。
export_docling_document_to_html
将文档导出为 HTML 格式。
save_docling_document
保存文档到文件。
retrieve_docling_document
按文档键检索缓存中的文档。
convert_to_markdown
将 PDF 直接转换为 Markdown 格式。
milvus_upload
将文档上传到 Milvus 向量数据库。
milvus_search
在 Milvus 中执行检索。
llama_index_rag_search
使用 LlamaIndex 执行 RAG 检索。
安装接入
- 安装包：
pip install docling-mcp或pip install docling-mcp[local]。 - 如有需要，配置环境变量（如
DOCLING_MCP_CONVERSION_MODE、DOCLING_MCP_SERVICE_URL等）。 - 使用
uvx --from docling-mcp docling-mcp-server --transport stdio启动服务器。
claude_desktop_config.json
{
"mcpServers": {
"docling": {
"command": "uvx",
"args": [
"--from=docling-mcp",
"docling-mcp-server"
],
"env": {
"DOCLING_MCP_CONVERSION_MODE": "remote",
"DOCLING_MCP_SERVICE_URL": "https://your-docling-service.example.com",
"DOCLING_MCP_SERVICE_API_KEY": "your-api-key-here"
}
}
}
}
选型与风险
不适合谁
- 不需要 MCP 集成的纯文档转换用户（可直接使用 Docling 库）。
- 完全不使用 AI 代理或 MCP 客户端的场景。
- 轻量级单次转换且无缓存需求的应用。
所需权限
- 读取本地文件（转换时需访问 PDF 文件）。
- 网络访问（远程模式必需，用于连接 Docling Serve；本地模式可选）。
- 环境变量权限（需设置 DOCLING_MCP_* 变量）。
- 存储权限（保存生成的文档或缓存）。
风险与副作用
- 远程模式下依赖 Docling Serve 服务，其不可用或高延迟会导致失败。
- API 密钥如果泄露可能被滥用，应谨慎保管。
- 本地转换模式依赖系统资源，大文档可能产生高内存消耗。
- OCR 和表格结构检测可能产生不准确的结果，需验证输出。
常见排障
- 检查 `DOCLING_MCP_CONVERSION_MODE` 是否为 'remote' 且 `DOCLING_MCP_SERVICE_URL` 正确。
- 确保 API 密钥有效并具有权限。
- 对于远程模式，检查网络连接和防火墙设置。
- 若遇到张量批处理错误，尝试增加 `DOCLING_MCP_IMAGES_SCALE`。
- 查看服务器日志以获取详细错误信息。
使用场景
将 PDF 文档转换为结构化 JSON 供 AI 应用使用。
通过 AI 代理创建、编辑和导出 Docling 文档。
在 RAG 流程中将文档嵌入向量数据库（如 Milvus）并检索。
为 LLM 提供本地或远程文档转换服务。
支持客户端
Claude Desktop完整支持
LM Studio完整支持
Llama Stack完整支持