ocr-images

🔌 AI コネクター · コンバーター + OCR

作成者：Oualid Messaoudi · 発行元：Vitalink ATLS Education GmbH Kipsburg 31, 44263 Dortmund · HRB 38336 · vitalink-atls-education.de v1.0.0 · MIT ライセンス

AI に、PDF や画像をそのまま送るのではなく、あらかじめ変換・軽量化されたドキュメントを読み取らせる、2 つのローカル MCP サーバーです。完全オフライン：ネットワークへのアクセスは一切ありません。

コネクター	機能	前提条件
convertisseur-ia	あらゆるドキュメントを軽量な Markdown に変換（テキスト付き PDF、Word、Excel、PowerPoint、CSV、HTML、JSON、XML、RTF、TXT、コード）＋トークン削減量を計算	Node.js ≥ 18（マルチプラットフォーム）
ocr-images	スキャン済みPDF、写真、スクリーンショットをテキスト化。Windows 組み込みOCRを使用 · 画像を軽量化してビジョンに対応	Node.js ≥ 18 ＋ Windows 10/11

一般的な削減例：88 Ko の PDF の書簡は、推定約 22 000 トークンから約 480に、スクリーンショットは約 945 画像トークンから約 90 テキストトークンになります。

---

インストール

公式 MCP レジストリ（io.github.Walmes1/convertisseur-ia、io.github.Walmes1/ocr-images）および npm に公開されています。手動でのインストールは不要で、npx がパッケージを取得します。

npx -y convertisseur-ia-mcp

npx -y ocr-images-mcp

ソースからインストールする場合：

git clone https://github.com/Walmes1/connecteurs-ia.git
cd connecteurs-ia/convertisseur-ia
npm install

ocr-images に依存関係はありません。インストールは不要です。

次に、MCP クライアント（Claude Desktop、Claude Code、Cursor、 VS Code、LM Studio など）に 2 つのサーバーを登録します。詳細は config-a-coller.json をご覧ください。

{
  "mcpServers": {
    "convertisseur-ia": {
      "command": "npx",
      "args": ["-y", "convertisseur-ia-mcp"]
    },
    "ocr-images": {
      "command": "npx",
      "args": ["-y", "ocr-images-mcp"]
    }
  }
}

設定ファイルの一般的な場所：

• Claude Desktop（Windows）：%APPDATA%\Claude\claude_desktop_config.json
• Claude Code：~/.claude.json

変更後、クライアントを再起動してください。

---

ツール

convertisseur-ia

ツール	説明
convertir_document	1 つのファイルを Markdown に変換し、トークン統計を表示します。オプション：max_chars、page_debut、page_fin
apercu_document	簡易プレビュー：種類、サイズ、推定トークン数、冒頭の文字列
convertir_dossier	フォルダー全体を 1 つの Markdown にまとめます。オプション：filtre、recursif、max_fichiers
enregistrer_markdown	変換した内容を、元のファイルと同じ場所に .md として保存します
formats_supportes	対応形式と例外的なケースの一覧

ocr-images

ツール	説明
ocr_image	写真／スクリーンショット／スキャン画像をテキスト化します。langue：auto、de、fr など
ocr_pdf	スキャン済み PDF をページごとにテキスト化します。オプション：pages（"1-3,7"）、qualite（デフォルトは 2、小さな文字には 3）
optimiser_image	画像を最大 1568 px の JPEG に縮小し、ビジョントークンを最大 −80 % 削減します
langues_ocr	Windows にインストールされている OCR 言語と、追加方法を表示します

2 つのツールの併用

document
   │
   ├─ couche texte présente ? ── oui ─▶  convertir_document   (rapide, fidèle)
   │
   └─ non (scan, photo)      ────────▶  ocr_pdf / ocr_image   (OCR Windows, ~1 s/page)

convertir_document はスキャン済み PDF を検出し、ocr_pdf を明示的に案内します。

---

仕組み

• 外部ライブラリ不要の Office 対応：.docx、.xlsx、.pptx は ZIP アーカイブです。 Node の zlib を基にした最小限の ZIP リーダーで読み込み、XML から Markdown に変換します。
• PDF：pdf.js でテキストレイヤーを抽出し、 ライブラリがない場合は組み込みの代替処理を使用します。
• OCR：Windows に標準搭載されている Windows.Media.Ocr を使用します。Tesseract、モデルのダウンロード、アカウントはいずれも不要です。PDF ページは Windows.Data.Pdf で画像に変換します。 langue: "auto" はインストール済みの各言語を試し、最良の結果を採用します。
• トークン：テキストは約 4 文字を 1 トークン、画像は largeur × hauteur / 750 として推定します。

---

プライバシーと範囲

• ネットワークへの呼び出しはありません。ファイルはディスクから読み込まれてメモリ上で変換され、変換後の Markdown のみが会話に送られます。
• これらのサーバーは、MCP クライアントから読み込みを指示されたローカルファイルを、フォルダーの制限なく読み取ります。これがローカルツールの原則です。信頼できるクライアントにのみ公開し、公開サービスの背後には決して配置しないでください。
• enregistrer_markdown と optimiser_image はファイルを書き込みます（デフォルトでは元のファイルと同じ場所）。それ以外のツールはディスクに書き込みません。
• OCR は完璧ではありません。金額、番号、手書き文字は元のファイルで確認してください。

---

トラブルシューティング

症状	解決策
コネクターが表示されない	MCP クライアントが再起動されていないか、設定ファイル内の mcpServers の配置が誤っています
「OCR 言語がインストールされていません」	Windows → 時刻と言語 → 言語と地域 → 言語のオプション → OCR にチェックを入れます
PDF が「スキャン済み」と表示される	テキストレイヤーがありません。ocr_pdf を使用してください
.doc / .xls / .ppt が拒否される	古いバイナリ形式です。.docx / .xlsx / .pptx として再保存してください
小さな文字の OCR 精度が低い	qualite: 3 を指定して ocr_pdf を使用します

簡易確認（ツールの一覧が表示されるはずです）：

echo {"jsonrpc":"2.0","id":1,"method":"tools/list"} | node convertisseur-ia/server.js

---

構成

Connecteurs-IA/
├── README.md · PUBLICATION.md · LICENSE · config-a-coller.json
├── _shared/mcp.js             micro-serveur MCP (stdio, 0 dépendance)
├── convertisseur-ia/
│   ├── server.js              5 outils
│   ├── server.json            manifeste registre MCP
│   └── lib/                   convert · office · zip · pdftext
└── ocr-images/
    ├── server.js              4 outils
    ├── server.json            manifeste registre MCP
    └── win-ocr.ps1            OCR Windows + rendu PDF + redimensionnement

---

ライセンス

MIT — © 2026 Vitalink ATLS Education GmbH, Dortmund (HRB 38336). Oualid Messaoudi が企画・開発しました。

配布用に予約されている名前：@vitalink-atls/convertisseur-ia-mcp, @vitalink-atls/ocr-images-mcp, de.vitalink-atls-education/convertisseur-ia, de.vitalink-atls-education/ocr-images — 詳細は PUBLICATION.md を参照してください。