作者 kreuzberg-dev · kreuzberg-dev/kreuzberg
通过 Rust 核心 MCP，从 PDF、Office 文档、图片及 97 种以上格式中提取干净的文本、表格和元数据。
Kreuzberg 是一个多格式文档智能框架。MCP 服务器封装了 Rust 核心处理管线：Claude 通过它从任意文档格式中提取结构化内容，无需依赖 Unstructured/Tika/pdfplumber。一次调用即可处理扫描版 PDF 的 OCR、表格识别和元数据提取。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"kreuzberg": {
"command": "uvx",
"args": [
"kreuzberg-mcp"
]
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"kreuzberg": {
"command": "uvx",
"args": [
"kreuzberg-mcp"
]
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"kreuzberg": {
"command": "uvx",
"args": [
"kreuzberg-mcp"
]
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"kreuzberg": {
"command": "uvx",
"args": [
"kreuzberg-mcp"
]
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "kreuzberg",
"command": "uvx",
"args": [
"kreuzberg-mcp"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"kreuzberg": {
"command": {
"path": "uvx",
"args": [
"kreuzberg-mcp"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add kreuzberg -- uvx kreuzberg-mcp一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你有一个 PDF，里面的表格被 pdftotext 弄得一团糟，又不想手动重录。
uvx kreuzberg-mcp——或通过 claude mcp add 添加结果： 可直接粘贴到文档的 Markdown 表格，无需二次整理。
何时使用： 客户给你一个压缩包，里面有 PDF、Word、PowerPoint，你需要提取纯文本用于向量化。
结果： 一批已清理的文本文件，附元数据清单，可直接用于向量化。
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| extract_text | path: str, ocr?: bool | 主要的文本提取调用 | free |
| extract_metadata | path: str | 只需要元数据，不需要正文 | free |
| extract_tables | path: str | 以表格为重点的提取场景 | free |
| detect_format | path: str | 提取前确认文件格式 | free |
ModuleNotFoundError: tesseract安装 Tesseract 系统二进制：brew install tesseract / apt install tesseract-ocr
`tesseract --version`Empty output on PDF很可能是纯图片 PDF——加上 ocr=true 重新运行
Check output.metadata.has_text_layerXLSX tables come out jumbled显式指定工作表名称：工具支持 sheet 参数
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| markdownify-mcp | 你想要一个更轻量的基于 Node 的转换器，不需要 OCR | 格式支持较少，不保留表格结构 |
| Unstructured.io | 你需要企业级 PDF 解析，且能接受云服务费用 | 付费；云托管 |