# deckprobe MCP server

> Inspect PDF, Office, and iWork documents for metadata, security signals, and structure without rendering the files.

- Repository: https://github.com/deckflow/deckprobe-mcp-server
- Page: https://hostedmcp.org/servers/deckflow/deckprobe-mcp-server
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add deckprobe-mcp-server -- npx -y @deckflow/deckprobe-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "deckprobe-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@deckflow/deckprobe-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "deckprobe-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@deckflow/deckprobe-mcp"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "deckprobe-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@deckflow/deckprobe-mcp"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.deckprobe-mcp-server]
command = "npx"
args = ["-y", "@deckflow/deckprobe-mcp"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "deckprobe-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@deckflow/deckprobe-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DECKPROBE_MCP_BIN` | no | no | Path to a DeckProbe binary to use instead of the bundled one. |
| `DECKPROBE_MCP_MAX_BATCH` | no | no | Maximum paths accepted by one probe_batch call. Defaults to 64. |
| `DECKPROBE_MCP_MAX_CONCURRENCY` | no | no | Maximum engine processes running at once. Defaults to 4. |
| `DECKPROBE_MCP_ROOTS` | no | no | Directories the server is allowed to read, separated like PATH. Unrestricted when unset. |
| `DECKPROBE_MCP_TIMEOUT_MS` | no | no | Hard per-call deadline on an engine process, in milliseconds. Defaults to 30000. |

## Tools (4)

- `probe`
- `probe_batch`
- `list_formats`
- `list_targets`

## FAQ

### Is it safe to use with untrusted files?

Yes, it is designed for untrusted input because it uses bounded parsing, no renderer, no macro interpreter, no external-reference resolution, and no network access.

### Can I inspect multiple documents at once?

Yes, the probe_batch tool allows you to inventory or triage many documents in a single call.

### Does the server require any pre-installed software?

No, npx fetches both the server and the engine together during installation.