MCP Mistral OCR

MCP Mistral OCR

Mistral AI の OCR API を使用して OCR 機能を提供する MCP サーバーです。このサーバーはローカルファイルと URL の両方を処理でき、画像と PDF に対応しています。

機能

• Mistral の OCR を使用してローカルファイル（画像と PDF）を処理します
• ファイル形式を明示的に指定して URL のファイルを処理します
• 複数のファイル形式（JPG、PNG、PDF など）に対応しています
• タイムスタンプ付きの JSON ファイルとして結果を保存します
• Docker によるコンテナ化
• UV によるパッケージ管理

環境変数

• MISTRAL_API_KEY：Mistral AI API キー
• OCR_DIR：ローカルファイル処理用のディレクトリパス。コンテナ内では、常に /data/ocr にマッピングされます

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の Mistral OCR を自動インストールするには：

npx -y @smithery/cli install @everaldo/mcp/mistral-crosswalk --client claude

Docker の使用

1. Docker イメージをビルドします：

docker build -t mcp-mistral-ocr .

2. コンテナを実行します：

docker run -e MISTRAL_API_KEY=your_api_key -e OCR_DIR=/data/ocr -v /path/to/local/files:/data/ocr mcp-mistral-ocr

ローカル開発

1. UV パッケージマネージャーをインストールします：

pip install uv

2. 仮想環境を作成して有効化します：

uv venv
source .venv/bin/activate  # On Unix
# or
.venv\Scripts\activate  # On Windows

3. 依存関係をインストールします：

uv pip install .

Claude Desktop の設定

この設定を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "mistral-ocr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MISTRAL_API_KEY",
        "-e",
        "OCR_DIR",
        "-v",
        "C:/path/to/your/files:/data/ocr",
        "mcp-mistral-ocr:latest"
      ],
      "env": {
        "MISTRAL_API_KEY": "<YOUR_MISTRAL_API_KEY>",
        "OCR_DIR": "C:/path/to/your/files"
      }
    }
  }
}

利用可能なツール

1. process_local_file

設定済みの OCR_DIR ディレクトリからファイルを処理します。

{
    "name": "process_local_file",
    "arguments": {
        "filename": "document.pdf"
    }
}

2. process_url_file

URL のファイルを処理します。ファイル形式を明示的に指定する必要があります。

{
    "name": "process_url_file",
    "arguments": {
        "url": "https://example.com/document",
        "file_type": "image"  // or "pdf"
    }
}

出力

OCR の結果は、OCR_DIR 内の output ディレクトリに JSON 形式で保存されます。各結果ファイルの名前は、次の形式になります：

• ローカルファイルの場合：{original_filename}_{timestamp}.json
• URL の場合：{url_filename}_{timestamp}.json。URL にファイル名が含まれていない場合は url_document_{timestamp}.json

タイムスタンプの形式は YYYYMMDD_HHMMSS です。

対応ファイル形式

• 画像：JPG、JPEG、PNG、GIF、WebP
• ドキュメント：PDF および Mistral OCR が対応するその他のドキュメント形式

制限事項

• 最大ファイルサイズ：50MB（Mistral API による制限）
• ドキュメントの最大ページ数：1000（Mistral API による制限）