-
securityF
license-
qualityProvides tools for reading and extracting text from PDF files, supporting both local files and URLs.
Last updated -
31
Supports containerized deployment using Docker, with configuration options for environment variables and volume mounting to access local files.
MCP Mistral OCR
An MCP server that provides OCR capabilities using Mistral AI's OCR API. This server can process both local files and URLs, supporting images and PDFs.
Features
Process local files (images and PDFs) using Mistral's OCR
Process files from URLs with explicit file type specification
Support for multiple file formats (JPG, PNG, PDF, etc.)
Results saved as JSON files with timestamps
Docker containerization
UV package management
Environment Variables
MISTRAL_API_KEY: Your Mistral AI API keyOCR_DIR: Directory path for local file processing. Inside the container, this is always mapped to/data/ocr
Installation
Installing via Smithery
To install Mistral OCR for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @everaldo/mcp/mistral-crosswalk --client claude
Using Docker
Build the Docker image:
docker build -t mcp-mistral-ocr .
Run the container:
docker run -e MISTRAL_API_KEY=your_api_key -e OCR_DIR=/data/ocr -v /path/to/local/files:/data/ocr mcp-mistral-ocr
Local Development
Install UV package manager:
pip install uv
Create and activate virtual environment:
uv venv
source .venv/bin/activate # On Unix
# or
.venv\Scripts\activate # On Windows
Install dependencies:
uv pip install .
Claude Desktop Configuration
Add this configuration to your 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"
}
}
}
}
Available Tools
1. process_local_file
Process a file from the configured OCR_DIR directory.
{
"name": "process_local_file",
"arguments": {
"filename": "document.pdf"
}
}
2. process_url_file
Process a file from a URL. Requires explicit file type specification.
{
"name": "process_url_file",
"arguments": {
"url": "https://example.com/document",
"file_type": "image" // or "pdf"
}
}
Output
OCR results are saved in JSON format in the output directory inside OCR_DIR. Each result file is named using the following format:
For local files:
{original_filename}_{timestamp}.jsonFor URLs:
{url_filename}_{timestamp}.jsonorurl_document_{timestamp}.jsonif no filename is found in the URL
The timestamp format is YYYYMMDD_HHMMSS.
Supported File Types
Images: JPG, JPEG, PNG, GIF, WebP
Documents: PDF and other document formats supported by Mistral OCR
Limitations
Maximum file size: 50MB (enforced by Mistral API)
Maximum document pages: 1000 (enforced by Mistral API)
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
OCR images or pdfs, locally or by URLs by using Mistral OCR API (paid)
- Features
- Environment Variables
- Installation
- Claude Desktop Configuration
- Available Tools
- Output
- Supported File Types
- Limitations
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables integration between MCP clients and the Handwriting OCR service, allowing users to upload images and PDF documents, check processing status, and retrieve OCR results as Markdown.Last updated -9
Textin MCP Serverofficial
AsecurityAlicenseAqualityA server that enables OCR capabilities to recognize text from images, PDFs, and Word documents, convert them to Markdown, and extract key information.Last updated -36923MIT License- -securityFlicense-qualityEnables reading and processing various document formats including Word, PDF, RTF, and text files. Supports extracting media elements like images and links, with features for PDF page range selection and automatic text encoding detection.Last updated -2