DeckProbe MCP Server

エージェントにPDF、Office、iWorkファイルの中身を尋ねさせる——開かずに。

インストール · ツール · 設定 · セキュリティ · 仕組み · DeckProbe

ドキュメント用のffprobeであるDeckProbeを4つの型付きツールとして公開するMCPサーバーです。ページ数、スライド数、メタデータ、暗号化とマクロのシグナル、構造、整合性を問い合わせると、信頼度、根拠、測定済みのI/Oコストを伴う、境界が定められた決定的なJSONが返ってきます。

レンダリングは一切行われず、マクロも実行されず、外部参照も追跡されず、ネットワーク接続も開かれません。信頼できないファイルを対象にしても安全です。

// probe { "path": "deck.pptx", "targets": ["slide_count"], "view": "values" }
{
  "schema_version": 2,
  "status": "ok",
  "driver": { "id": "powerpoint", "profile": "pptx" },
  "values": { "powerpoint.slide_count": 31 },
  "view": "values"
}

インストール

事前にインストールするものはありません——npxがサーバーとエンジンをまとめて取得します。

Claude Code

claude mcp add deckprobe -- npx -y @deckflow/deckprobe-mcp

Claude Desktop、Cursor、VS Code、Zed、その他mcpServersを読み取るすべてのクライアント

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

固定バージョンをインストールするには、npm install -g @deckflow/deckprobe-mcpを実行し、コマンドとしてdeckprobe-mcpを使用します。

Node.js 20以降が必要です。エンジンバイナリは、macOS、Linux（glibcおよびmusl）、Windowsのx86-64およびARM64向けに、プラットフォーム別のオプショナル依存関係として提供されます。それ以外の環境では、サーバーは同じエンジンをWebAssemblyにコンパイルしたものにフォールバックするため、npxはNodeが動作する場所ならどこでも機能します。

Related MCP server: document-parser

ツール

また、実行中のエンジンに同梱されているレポートJSON Schemaを運ぶリソースdeckprobe://schemaも1つあります。

probe

{
  "path": "reports/q3.pptx",
  "targets": ["@summary", "@security"],  // presets, short names, or canonical names
  "level": "metadata",                   // header | metadata | deep
  "min_confidence": "high",              // low | medium | high | exact
  "target_confidence": { "slide_count": "exact" },
  "view": "report",                      // report | values
  "budget": { "max_physical_bytes": 8388608, "timeout_ms": 1000 }
}

targetsは短い名前（slide_count）、正規名（powerpoint.slide_count）、およびプリセットを受け付けます：

@summaryは、ファイル全体の読み取りを必要とする統計を意図的に省略します。PDFのpage_countが代表的なケースです——明示的に要求してください。

probe_batch

{ "paths": ["a.pdf", "b.pptx", "c.xlsx"], "targets": ["@security"] }

1つのエンジンプロセスがバッチ全体を処理します。結果は入力順に返され、各結果には独自のレポートまたは独自のエラーが付くため、1つの不良ファイルが実行全体を台無しにすることはありません。デフォルトはコンパクトなvaluesビューです。リテラルパスのみ——グロブ展開は自分で行ってください。

list_formatsとlist_targets

list_targetsはformat（pdf、docx、xlsx、pptx、doc、xls、ppt、key、numbers、pages）を受け取り、各ターゲットのエイリアス、説明、値の型、最小レベル、コストクラス、セレクタのメンバーシップを返します。エンジンの完全なレポート（ターゲットごとのJSON Schemaフラグメントと展開済みセレクタリストを含む）が必要な場合は、detail: "full"を渡してください。

どちらもサーバープロセスの存続期間中キャッシュされます。

レポートの読み方

ツールの結果は、エンジン自身のschema-v2エンベロープをそのまま返したものです。消費する前に知っておくべきことが2つあります：

• status: "partial"は失敗ではありません。 要求されたターゲットの少なくとも1つが、要求された信頼度で解決できなかったことを意味します。それはexecution.unresolved_targetsに名前が挙げられ、他のすべての結果は依然として有効です。

• confidence_scoreはラベルごとの固定定数（0.4、0.7、0.95、1.0）であり、校正された確率ではありません。0.95は値が95%の確率で正しいことを意味しません。

valueを持つのは、ステータスがresolvedまたはestimatedの結果のみです。unknownは一般的で、通常はドキュメントが単にその事実を記録していないことを意味します。

失敗した呼び出しは、エンジンのエラーエンベロープに加えて、対処方法を1行添えてisErrorを返します。エンジンが実行される前にサーバー自身が発生させる失敗——パスの欠落、ディレクトリ、許可リスト外のパス、期限超過——は、MCP_プレフィックス付きのコードとorigin: "mcp-server"を持つ同じエンベロープ形式を使用します。

設定

すべての設定は環境変数であり、クライアントのMCP設定で設定します。すべてオプションです。

{
  "deckprobe": {
    "command": "npx",
    "args": ["-y", "@deckflow/deckprobe-mcp"],
    "env": { "DECKPROBE_MCP_ROOTS": "/Users/me/Documents:/Users/me/Downloads" }
  }
}

セキュリティ

DeckProbeは信頼できない入力のために作られています：境界のある解析、レンダラーなし、マクロインタープリタなし、外部参照の解決なし、ネットワークアクセスなし。このサーバーはその上に2つのことを追加します。

• プロセス分離とハード期限。 各プローブは独自の短命プロセスで実行され、DECKPROBE_MCP_TIMEOUT_MSを超えると強制終了されます。

• オプションの読み取り許可リスト。 DECKPROBE_MCP_ROOTSは到達可能なツリーを固定します。パスはチェック前にシンボリックリンクが解決されるため、リンクで回避することはできません。デフォルトは制限なしで、ユーザーが自分で実行できるCLIと一致します——共有または自動化されたデプロイメントでは設定してください。

レポートはドキュメントの内容を再現するのではなく、ドキュメント（メタデータ、カウント、シグナル）を記述します。ドキュメントのタイトルなどのレポート値は依然として攻撃者が制御する文字列であることに注意してください：サーバーはそれらをJSONデータとして透過させ、指示に補間することは決してなく、消費者も同様に扱うべきです。

脆弱性はSECURITY.mdに記載されているとおり、非公開で報告してください。

仕組み

MCP client
    │  JSON-RPC over stdio
    ▼
deckprobe-mcp ── validates arguments, resolves the path, maps the result
    │  argv + stdout (one process per probe, or one --jsonl process per batch)
    ▼
DeckProbe engine ── plans the cheapest paths that answer the request

サーバーはWebAssemblyビルドを呼び出すのではなく、ネイティブのDeckProbe CLIを起動します。CLIはプローブプランが必要とするバイトレンジのみを読み取ります。一方、WebAssemblyパスはファイル全体をメモリに保持し、別のOSプロセスが信頼できない解析を分離すると同時に完全に強制終了できるようにします。エンジンは次の順序で選択されます：

1. DECKPROBE_MCP_BIN

2. このパッケージの@deckflow/deckprobe依存関係に同梱されているバイナリ

3. PATH上のdeckprobe

4. 同梱のWebAssemblyエンジン

解決されたエンジンは起動時にstderrに記録されます。stdoutはMCPトランスポートに属し、それ以外は何も運びません。

MCPサーバーか、エージェントスキルか？

DeckProbeには、シェル対応エージェントにCLIを直接使用する方法を教えるAgent Skillも同梱されています。どちらも同じ語彙を教えます。エージェントにシェルがあり、CLIの全機能が必要な場合はスキルを使用してください。シェルがない場合、またはエンジンが実行される前に型付き引数を検証したい場合は、このサーバーを使用してください。

開発

npm install
npm test          # typecheck, lint, build, and the full suite
npm run test:watch

貢献は歓迎します——CONTRIBUTING.mdを参照してください。却下された代替案を含む設計の根拠はdocs/rfc.mdにあります。

ライセンス

MIT。LICENSEを参照してください。