MCP Mistral OCR

一个MCP服务器，使用Mistral AI的OCR API提供光学字符识别功能。该服务器支持处理本地文件和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  # 在Unix系统上
# 或者在Windows系统上
.venv\Scripts\activate

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" // 或 "pdf"
    }
}

输出

OCR结果保存在OCR_DIR目录中的output文件夹内。每个结果文件的命名格式如下：

• 对于本地文件：{original_filename}_{timestamp}.json
• 对于URL：{url_filename}_{timestamp}.json 或 url_document_{timestamp}.json（如果URL中未找到文件名）

时间戳格式为YYYYMMDD_HHMMSS。

支持的文件类型

• 图像：JPG、JPEG、PNG、GIF、WebP
• PDF

注意事项

请确保API密钥的安全性，并避免在明文环境中暴露。