ClicheFactory Document Intelligence

clichefactory-mcp

ClicheFactory 用の MCP（Model Context Protocol）サーバーです。ドキュメントから構造化データを抽出します。

このサーバーは、ClicheFactory の抽出機能とドキュメント変換機能を MCP ツールとして提供します。これにより、Cursor、Claude Desktop、OpenClaw、その他の MCP 互換クライアントの AI アシスタントが、PDF、画像、DOCX、XLSX、CSV、EML などから構造化データを抽出できます。

クイックスタート（推奨 — サービスモード）

サービスモードでは、最適な抽出品質を得るために ClicheFactory クラウドを使用します。必要なのは API キー 1 つだけです。

1. clichefactory.com で登録します。無料で利用できるページが含まれており、クレジットカードは不要です。

2. Settings → API Keys で API キーを作成します（形式：cliche-...）。

3. MCP サーバーをインストールします。

   pip install clichefactory-mcp
   

4. 設定します。MCP クライアントにキーを貼り付ける（下記を参照）か、ターミナルで一度だけ次のコマンドを実行します。

   pip install clichefactory   # if you don't have the CLI yet
   clichefactory configure
   

   対話型ウィザードが認証情報を ~/.clichefactory/config.toml に保存します。MCP サーバーはこのファイルを自動的に読み込みます。

これで完了です。環境変数 1 つ（CLICHEFACTORY_API_KEY）または設定ファイルがあれば、ホスト型の抽出を利用できます。

ツール

ツール	説明
extract	スキーマを使ってドキュメントから構造化 JSON を抽出します
to_markdown	ドキュメントを Markdown テキストに変換します
doctor	設定、依存関係、システムバイナリを確認します

extract

メインのツールです。ドキュメントファイルと JSON スキーマを渡すと、構造化データが返されます。

すべての抽出モードに対応しています。

モード	説明	必要なもの
(デフォルト)	OCR + LLM による抽出	サービス API キー（推奨）
fast	最速のパイプライン	サービス API キー
trained	学習済みパイプラインのアーティファクト	サービス + artifact_id
robust	2 段階の抽出 + 検証	サービスのみ
robust-trained	学習済みの抽出 + 検証	サービス + artifact_id

スキーマは次の方法で指定できます。

• ファイルパス：.json スキーマファイルの絶対パス
• インライン辞書：LLM が会話から JSON スキーマを構築します（例：ユーザーが 「請求書番号と合計金額を抽出して」 と伝えると、LLM が {"type": "object", "properties": {"invoice_number": {"type": "string"}, "total": {"type": "number"}}} を構築します）

to_markdown

対応するドキュメントを Markdown に変換します。ドキュメントの内容を確認したり、抽出スキーマを決める前に分析用として LLM に渡したりする場合に便利です。

doctor

ClicheFactory のセットアップ（設定ファイル、API キー、Python の依存関係、システムバイナリ）を診断します。正常に動作しない場合に呼び出してください。

実行モード

サーバーはデフォルトでサービスモード（ClicheFactory クラウド）を使用します。BYOK／エアギャップ環境向けにローカルモードも利用できます。

• service （推奨） — ClicheFactory クラウドサービスを使用します。ClicheFactory API キーが必要です。学習済みパイプラインや堅牢な検証など、すべての抽出モードに対応しています。初期状態から最高の抽出品質を得られます。

• local （上級者向け） — お使いのマシン上で抽出を実行します。ご自身の LLM キーを使用します（BYOK）。pip install "clichefactory-mcp[local]"（解析／OCR の依存関係に約 2 GB）に加えて、システムバイナリ（tesseract、LibreOffice）が必要です。品質はローカル環境の設定に左右されます。

インストール

前提条件

• Python ≥ 3.12
• uv（推奨）または pip

PyPI から

pip install clichefactory-mcp

ローカルモードで抽出を実行する場合（BYOK、お使いのマシン上で実行）、ローカル用の追加機能を指定してインストールします。

pip install "clichefactory-mcp[local]"

設定

環境変数

以下を MCP クライアントの設定（下記参照）に追加するか、clichefactory configure を使って ~/.clichefactory/config.toml に設定してください。

変数	必須	説明
CLICHEFACTORY_API_KEY	はい（サービスモード）	Settings → API Keys から取得した ClicheFactory API キー（cliche-...）
CLICHEFACTORY_API_URL	いいえ	デフォルトのサービス URL（https://api.clichefactory.com）を上書きします。セルフホスト可能な ClicheFactory バックエンドを使ったローカル開発に便利です
LLM_MODEL_NAME	ローカルモードのみ	モデル名（例：gemini/gemini-3-flash-preview）
LLM_API_KEY	ローカルモードのみ	LLM プロバイダーの API キー
OCR_MODEL_NAME	いいえ	別の OCR/VLM モデル（デフォルトではメインモデルを使用）
OCR_API_KEY	いいえ	OCR モデルの API キー（デフォルトではメインのキーを使用）

環境変数は、~/.clichefactory/config.toml の設定より優先されます。

Cursor

プロジェクトの .cursor/mcp.json（または Cursor のグローバル設定）に追加してください。

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "CLICHEFACTORY_API_KEY": "cliche-your-key-here"
      }
    }
  }
}

git チェックアウトからローカル開発する場合は、uvx を次のように置き換えてください。

"command": "uv",
"args": ["--directory", "/absolute/path/to/cliche-mcp", "run", "clichefactory-mcp"]

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加してください。

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "CLICHEFACTORY_API_KEY": "cliche-your-key-here"
      }
    }
  }
}

OpenClaw

OpenClaw エージェントに MCP サーバーを登録してください。

openclaw mcp set clichefactory '{"command":"uvx","args":["clichefactory-mcp"],"env":{"CLICHEFACTORY_API_KEY":"cliche-your-key-here"}}'

openclaw mcp list で確認してください。エージェントは、あらゆる会話で extract、to_markdown、doctor ツールを使えるようになります。

エージェント向けの指示を含む OpenClaw スキルも、integrations/openclaw/ で利用できます。ワークスペースにインストールするには、次のように実行してください。

cp -r /path/to/cliche-mcp/integrations/openclaw ~/.openclaw/skills/clichefactory

または、ClawHub で公開された後は、次のように実行してください。

openclaw skills install clichefactory

ローカルモード（上級者向け）

お使いのマシンで BYOK 抽出を行う場合は、ローカル用の追加パッケージをインストールし、LLM の認証情報を設定してください。

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "LLM_MODEL_NAME": "gemini/gemini-3-flash-preview",
        "LLM_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

ツールの呼び出し時に mode="local" を明示的に指定するか、clichefactory configure --local を実行して、~/.clichefactory/config.toml でローカルモードをデフォルトに設定してください。

対応ファイル形式

PDF、PNG、JPG、JPEG、WebP、GIF、BMP、DOCX、DOC、ODT、XLSX、CSV、EML、TXT、MD。

CLI との違い

この MCP サーバーは、主要な抽出および変換のワークフローに対応しています。以下の CLI 機能は v1 には含まれていません。

機能	理由
バッチ処理（extract-batch、to-markdown-batch）	MCP ツールは通常、LLM から一度に 1 つずつ呼び出されます。複数のドキュメントを処理する場合、LLM は extract を順番に呼び出します。今後のバージョンでバッチ処理が追加される可能性があります。
configure	MCP では対話形式のプロンプトが機能しません。環境変数を使うか、ターミナルで clichefactory configure を実行してください。
--output / -o フラグ	MCP ツールはファイルに書き込むのではなく、結果を直接 LLM に返します。
allow_partial	v1 ではツールのパラメーターとして公開されていません。
OCR エンジンの選択	SDK のデフォルト（RapidOCR）を使用します。必要に応じて、~/.clichefactory/config.toml で設定するか、SDK 経由で解析オプションを渡してください。

開発

# Install in development mode
uv sync

# Run the server directly (stdio transport, for testing with MCP clients)
uv run clichefactory-mcp

# Inspect available tools (requires mcp CLI)
uv run mcp dev cliche_mcp/server.py

ライセンス

MIT — Copyright (c) 2026 Urban Susnik s.p.