Mistral OCR MCP

A local stdio MCP server that extracts Markdown from PDF and image files through a Mistral-compatible OCR API. Documents are read locally and sent as Mistral data URLs to the configured /v1/ocr endpoint.

Requirements

• Node.js 20 or newer
• A Mistral-compatible OCR endpoint
• An API key authorized for the configured OCR model

OpenCode konfigurieren

Den folgenden Eintrag in die globale ~/.config/opencode/opencode.json oder die projektbezogene opencode.json aufnehmen:

{
  "mcp": {
    "mistral-ocr": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "--package=@viadee/mistral-ocr-mcp",
        "mistral-ocr-mcp"
      ],
      "enabled": true,
      "timeout": 310000,
      "environment": {
        "MISTRAL_API_KEY": "{env:OPENCODE_LITELLM_API_KEY}",
        "MISTRAL_BASE_URL": "https://your-ocr-endpoint.example",
        "MISTRAL_OCR_MODEL": "your-ocr-model"
      }
    }
  }
}

OpenCode danach vollstaendig neu starten. Das Tool extract_file_content akzeptiert einen absoluten oder zum Arbeitsverzeichnis relativen Pfad zu einer lokalen PDF- oder Bilddatei.

Configuration

| Variable | Required | Default | Description | | --- | --- | --- | --- | | MISTRAL_API_KEY | yes | | API key for the configured endpoint | | MISTRAL_BASE_URL | no | https://api.mistral.ai | API base URL, with or without /v1 | | MISTRAL_OCR_MODEL | no | mistral-ocr-latest | OCR model or endpoint alias | | OCR_ALLOWED_DIRECTORIES | no | unrestricted | Semicolon- or comma-separated directories | | OCR_MAX_DOCUMENT_BYTES | no | 10485760 | Maximum local document size | | OCR_MAX_EXTRACTED_TEXT_CHARS | no | unlimited | Optional output limit; unset returns complete OCR text | | OCR_MAX_RESPONSE_BYTES | no | 10485760 | Maximum OCR response size before parsing | | OCR_REQUEST_TIMEOUT_MS | no | 300000 | Upstream request timeout |

Supported formats are PDF, JPEG, PNG, TIFF, BMP, and WebP. Symlinks are resolved before the allowed-directory check.

Development

npm ci
npm test
npm run check
npm run build
npm pack --dry-run
npm audit --omit=dev

The TypeScript source is compiled to the JavaScript files in build/. Declaration files and source maps are not generated because this package is a CLI, not a library. Unit tests do not require credentials or external services.

Releases

Push a v* tag to run the GitHub Actions release workflow. npm trusted publishing authenticates the workflow through OIDC; no npm token secret is required. The GitHub repository is private, so npm provenance is not generated.