kreuzberg MCP工具

Installation

CLI & Deployment

<details> <summary><strong>CLI Tool</strong></summary>

brew install xberg-io/tap/xberg

12 commands: extract, batch, detect, formats, version, cache (stats/clear/manifest/warm), serve, mcp, api, embed, chunk, completions.

See CLI usage guide for detailed documentation.

</details>

<details> <summary><strong>Docker</strong></summary>

docker pull ghcr.io/xberg-io/xberg:latest

Run in API, CLI, or MCP modes. See Docker guide for examples.

</details>

<details> <summary><strong>REST API Server</strong></summary>

xberg serve --host 0.0.0.0 --port 8000

One POST endpoint handles all formats. Returns JSON or Markdown. Stream large files. See API server guide.

</details>

<details> <summary><strong>MCP Server</strong></summary>

xberg mcp --transport stdio

9 tools (extract, extract_batch, detect_mime_type, cache_stats, list_formats, cache_clear, get_version, cache_manifest, cache_warm). 3 prompts (extract_document, extract_with_ocr, semantic_search). 4 resources (formats, models, OCR languages, embedding presets).

Add to Claude Desktop or Cursor:

{
  "mcpServers": {
    "xberg": { "command": "xberg", "args": ["mcp"] }
  }
}

See MCP integration guide.

</details>

Deployment Modes

Quick Start

Extract text from a document:

use xberg::{extract, ExtractInput, ExtractionConfig};

#[tokio::main]
async fn main() -> xberg::Result<()> {
    let config = ExtractionConfig::default();
    let output = extract(
        ExtractInput::from_uri("document.pdf"),
        &config
    ).await?;

    println!("{}", output.results[0].content);
    Ok(())
}

Common use cases — see Quick start guide for language-specific examples, OCR, batch processing, and API configuration.

---

Demos

<p align="center"><img src="docs/assets/demos/cli.gif" alt="Xberg CLI: extract, batch, detect, formats, cache, serve, mcp" width="760"></p> <p align="center"><em>The CLI: 12 commands for extraction, caching, serving, and MCP.</em></p>

<p align="center"><img src="docs/assets/demos/ocr.gif" alt="OCR from a scanned image with confidence scores and bounding boxes" width="820"></p> <p align="center"><em>OCR with confidence scores and bounding boxes. Switch backends without code changes.</em></p>

<p align="center"><img src="docs/assets/demos/crawl.gif" alt="Crawling a website and extracting all linked documents" width="820"></p> <p align="center"><em>Web crawl: fetch a page, follow links, extract all documents recursively.</em></p>

<p align="center"><img src="docs/assets/demos/mcp.gif" alt="MCP server integration with Claude Desktop showing extraction tools and prompts" width="820"></p> <p align="center"><em>MCP server: AI agents extract documents, detect formats, warm models, manage cache.</em></p>

<p align="center"><img src="docs/assets/demos/serve.gif" alt="REST API: POST a document, get JSON extraction results with streaming support" width="820"></p> <p align="center"><em>REST API: stream large files, get JSON or Markdown, one endpoint for all formats.</em></p>

---

CLI Reference

<details> <summary><strong>All 12 commands</strong></summary>

Run xberg --help or xberg <command> --help for detailed options.

</details>

---

Language Packages

<details open> <summary><strong>Python</strong></summary>

pip install xberg

See Python README for full documentation.

</details>

<details> <summary><strong>Node.js / TypeScript</strong></summary>

npm install @xberg-io/xberg

See Node.js README for full documentation.

</details>

<details> <summary><strong>Rust</strong></summary>

cargo add xberg

See Rust README for full documentation.

</details>

<details> <summary><strong>Go</strong></summary>

go get github.com/xberg-io/xberg

See Go README for full documentation.

</details>

<details> <summary><strong>Java</strong></summary>

Available on Maven Central as io.xberg:xberg. See Java README for the dependency snippet.

</details>

<details> <summary><strong>C#</strong></summary>

dotnet add package Xberg

See C# README for full documentation.

</details>

<details> <summary><strong>Ruby</strong></summary>

gem install xberg

See Ruby README for full documentation.

</details>

<details> <summary><strong>PHP</strong></summary>

composer require xberg-io/xberg

See PHP README for full documentation.

</details>

<details> <summary><strong>Elixir</strong></summary>

Add {:xberg, "~> 1.0"} to your mix.exs dependencies. See Elixir README for full documentation.

</details>

<details> <summary><strong>WebAssembly</strong></summary>

npm install @xberg-io/xberg-wasm

See WebAssembly README for full documentation.

</details>

<details> <summary><strong>R</strong></summary>

Install from r-universe. See R README for full documentation.

</details>

<details> <summary><strong>Kotlin (Android)</strong></summary>

Available on Maven Central as io.xberg:xberg-android. See Kotlin README for the dependency snippet.

</details>

<details> <summary><strong>Swift</strong></summary>

Add via Swift Package Manager. See Swift README for full documentation.

</details>

<details> <summary><strong>Dart / Flutter</strong></summary>

dart pub add xberg

See Dart README for full documentation.

</details>

<details> <summary><strong>Zig</strong></summary>

Add via zig fetch. See Zig README for full documentation.

</details>

<details> <summary><strong>C/C++ (FFI)</strong></summary>

Build from source as part of this workspace. See C (FFI) README for full documentation.

</details>