Máy chủ MCP OCR hộ chiếu dành cho AI agent

Agent của bạn nhận lại gì

Đây là khác biệt quan trọng. Một công cụ OCR trả về cả trang văn bản sẽ bắt mô hình phải phân tích lại, và một mô hình bị yêu cầu phân tích lại ngày tháng thì sớm muộn cũng sẽ bịa ra một ngày. Công cụ này trả về các trường đã được tách sẵn:

• Người sở hữu – tên, họ, ngày sinh, giới tính, quốc tịch.
• Giấy tờ – loại, quốc gia, quốc gia cấp, số, sê-ri, ngày cấp, ngày hết hạn, đã hết hạn hay chưa, và còn bao nhiêu ngày.
• Mọi trường tìm thấy, mỗi trường có độ tin cậy riêng, được đọc riêng từ vùng đọc máy (MRZ) và từ vùng thị giác in trên giấy tờ – để mô hình thấy được hai kết quả đọc khớp nhau, thay vì phải giả định.
• Vùng đọc máy kèm kết luận: đạt, không đạt hoặc không có, cùng lý do, và chính các dòng MRZ.
• Một bản tóm tắt một dòng mà trợ lý có thể hiển thị cho bạn trong lúc làm việc.

Lỗi được trả về dưới dạng một dòng dễ đọc trong khối lỗi, không bao giờ là một kết quả rỗng im lặng: trợ lý có thể xử lý theo đó và hiển thị cho bạn. Một lần từ chối từ API giữ nguyên cách diễn đạt của chính API, mã lỗi của nó, và liên kết tới trang giải thích lỗi đó.

Cài đặt vào client của bạn

Thêm khối này vào cấu hình MCP của client rồi khởi động lại client. Đặt DOC_CHEAP_API_KEY bằng khóa của riêng bạn, hoặc bỏ trống để dùng khóa sandbox công khai.

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

claude mcp add-json doc-cheap '{"command":"npx","args":["-y","@doc-cheap/mcp"],"env":{"DOC_CHEAP_API_KEY":"sk_live_your_key"}}'

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "servers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "type": "stdio",
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "disabled": false,
      "autoApprove": [
        "check_balance",
        "search_docs"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

• Khởi động lại client sau khi thêm khối cấu hình. Máy chủ do client khởi chạy, nên nó chỉ nhận cấu hình và biến môi trường đã thay đổi khi khởi động lại từ đầu.
• Không có DOC_CHEAP_API_KEY, máy chủ dùng khóa sandbox công khai thay thế: các lần quét khi đó chạy trong hạn mức miễn phí của khóa này và không có số dư nào để báo cáo. Đó là cách nhanh nhất để thấy nó hoạt động.
• Thiết lập tùy chọn: DOC_CHEAP_DOCS_BASE (nơi kết quả tìm kiếm liên kết tới), DOC_CHEAP_DOCS_DIR (bản tài liệu nào được tìm kiếm), và DOC_CHEAP_IMAGE_ROOT (xem phần cơ chế bảo vệ bên dưới).

Hoặc kết nối tới máy chủ được lưu trữ sẵn

Cùng ba công cụ đó được lưu trữ tại https://mcp.doc.cheap/mcp qua Streamable HTTP, nên client kết nối bằng URL không cần cài đặt gì. Không cần đăng nhập: gửi khóa của bạn qua X-Doc-Cheap-Api-Key hoặc Authorization: Bearer – nếu gửi cả hai, header có tên riêng sẽ được ưu tiên – hoặc không gửi gì và khóa sandbox công khai sẽ được dùng. Máy chủ lưu trữ sẵn không đọc được tệp trên máy của bạn, nên nó nhận ảnh dưới dạng base64 hoặc một URL https.

https://mcp.doc.cheap/mcp

claude mcp add --transport http doc-cheap https://mcp.doc.cheap/mcp --header "Authorization: Bearer sk_live_your_key"

{
  "mcpServers": {
    "doc-cheap": {
      "url": "https://mcp.doc.cheap/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key"
      }
    }
  }
}

{
  "servers": {
    "doc-cheap": {
      "type": "http",
      "url": "https://mcp.doc.cheap/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key"
      }
    }
  }
}

Trong Claude Desktop và claude.ai, thêm nó tại Settings, Connectors, dưới dạng custom connector với URL https://mcp.doc.cheap/mcp; nếu không có khóa, nó chạy bằng khóa sandbox.

Ba công cụ

• scan_document nhận ảnh qua image_base64, image_path hoặc image_url, cùng các tùy chọn giống một lệnh gọi trực tiếp, trong đó có expect_country, return_portrait, reference và idempotency_key.
• search_docs đọc bản tài liệu được đóng gói cùng máy chủ, nên nó trả lời mà không cần mạng – nghĩa là agent có thể tra cứu bộ từ vựng các trường hoặc một mã lỗi mà không tốn lệnh gọi nào.
• check_balance cần một khóa gắn với tài khoản. Với khóa sandbox công khai, nó nói rõ rằng không có số dư, thay vì trả về các số 0 trông như một kết quả đọc thật.
• Mỗi công cụ khai báo một output schema và trả về nội dung có cấu trúc khớp với schema đó, nên agent có thể dùng các trường mà không phải phân tích văn bản.
• Mỗi trang tài liệu cũng là một resource mà agent có thể đọc, và bốn prompt – đọc giấy tờ thành JSON, kiểm tra ngày hết hạn, quét một loạt, giải thích mã lỗi – khởi động các tác vụ thường gặp chỉ trong một bước.

Chi phí

$0.01 cho mỗi giấy tờ được nhận dạng. Giá cố định, cho mọi tài khoản, ở mọi khối lượng – một con số duy nhất, không có gì phải thương lượng. Giấy tờ chỉ bị tính phí khi đã được nhận dạng: một lần quét không tìm thấy gì, không đọc được ảnh hoặc không xác định được loại giấy tờ sẽ trả về kết luận của nó và không mất phí. Mỗi kết quả đều cho biết đó là trường hợp nào, nên agent – và bạn – luôn biết lệnh gọi đó có tốn gì không.

Trước khi có tài khoản: khóa sandbox công khai chạy tổng cộng 10 giấy tờ được nhận dạng miễn phí cho mỗi địa chỉ IP, tối đa 10 yêu cầu mỗi giờ bất kể kết quả trả về, và khi đăng ký bạn được cộng thêm 20 credit. Một credit là một cent, và một cent là một giấy tờ.

Việc nhận dạng mất khoảng 275 ms ở mức trung vị trên production, và mỗi kết quả kèm thời gian xử lý của chính nó, nên vòng lặp của agent có thể lập ngân sách dựa trên một con số thực.

Cùng mức giá, cùng khóa và cùng cấu trúc phản hồi như một lệnh gọi trực tiếp: cách tính phí, và so sánh với các lựa chọn khác.

Máy chủ báo cáo những gì

Theo mặc định, máy chủ không gửi báo cáo đi đâu cả: tính năng báo lỗi bị tắt trừ khi bạn tự đặt một endpoint nhận báo cáo, và khi không có endpoint thì thư viện theo dõi lỗi thậm chí không được tải.

Hai cơ chế bảo vệ nên biết

Máy chủ chạy trên máy của bạn với quyền của bạn, và các tham số của nó do mô hình chọn. Vì vậy hai trong số đó được rào chắn:

image_base64 không chịu ràng buộc nào trong số này, vì bên gọi đã nắm sẵn các byte dữ liệu – đó là lý do mọi lần từ chối ở trên đều hướng bạn tới nó.