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 结果以 JSON 格式保存在 OCR_DIR 内的 output 目录中。每个结果文件都按以下格式命名：

• 本地文件：{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 限制）