MCP Mistral Ocr

🚀 MCP Mistral OCR

MCP Mistral OCR是一個MCP服務器，藉助Mistral AI的OCR API實現光學字符識別功能。該服務器支持處理本地文件和URL，可處理圖像和PDF文件，為用戶提供便捷的OCR服務。

✨ 主要特性

• 本地文件處理：使用Mistral的OCR處理本地文件（圖像和PDF）。
• URL文件處理：能處理帶有明確文件類型指定的URL文件。
• 多格式支持：支持多種文件格式，如JPG、PNG、PDF等。
• 結果保存：將OCR結果保存為帶時間戳的JSON文件。
• 容器化部署：採用Docker容器化技術，方便部署和管理。
• 包管理：使用UV包管理工具。

📦 安裝指南

通過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密鑰的安全性，並避免在明文環境中暴露。

🔧 技術細節

環境變量