mcp-mistral-ocr

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Supports containerized deployment using Docker, with configuration options for environment variables and volume mounting to access local files.

MCP ミストラル 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 .
  1. コンテナを実行します。
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
  1. 仮想環境を作成してアクティブ化します。
uv venv source .venv/bin/activate # On Unix # or .venv\Scripts\activate # On Windows
  1. 依存関係をインストールします:
uv pip install .

クロードデスクトップ構成

この設定を 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. プロセスローカルファイル

設定された OCR_DIR ディレクトリからファイルを処理します。

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

2. プロセスURLファイル

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
  • ドキュメント: Mistral OCR でサポートされている PDF およびその他のドキュメント形式

制限事項

  • 最大ファイルサイズ: 50 MB (Mistral API によって強制)
  • 最大ドキュメントページ数: 1000 (Mistral API によって強制)
-
security - not tested
F
license - not found
-
quality - not tested

Mistral OCR API(有料)を使用して、ローカルまたは URL 経由で画像または PDF を OCR します。

  1. Features
    1. Environment Variables
      1. Installation
        1. Installing via Smithery
        2. Using Docker
        3. Local Development
      2. Claude Desktop Configuration
        1. Available Tools
          1. 1. process_local_file
          2. 2. process_url_file
        2. Output
          1. Supported File Types
            1. Limitations
              ID: 798rkh8r8l