Handwriting OCR

Handwriting OCR MCP Server

Um servidor Model Context Protocol (MCP) para Handwriting OCR.

⭐ Recomendado: use o servidor MCP hospedado (remoto)

Você não precisa mais executar este servidor local. O Handwriting OCR agora oferece um servidor MCP hospedado ao qual você se conecta diretamente — sem instalação do Node.js, sem etapa de build e sem copiar um token de API.

• Endpoint: https://mcp.handwritingocr.com
• Autenticação: OAuth — seu cliente MCP abre uma página de login e consentimento no seu navegador; não há token para copiar ou armazenar.
• Mais recursos do que este servidor local: envie documentos, verifique o status, recupere resultados, exporte para Word / Excel / JSON e use extratores para extração estruturada de campos. Ele também inclui um guia de uso integrado para que seu assistente saiba o que o serviço faz e como obter bons resultados.

Adicione-o a qualquer cliente que suporte servidores MCP remotos. Por exemplo, na configuração do Claude Desktop:

{
    "mcpServers": {
        "handwriting-ocr": {
            "url": "https://mcp.handwritingocr.com"
        }
    }
}

A forma exata de adicionar um servidor remoto varia conforme o cliente (alguns têm uma interface de "Conectores", outros precisam de "type": "http", e clientes somente stdio podem fazer a ponte via proxy mcp-remote). Consulte a documentação de MCP remoto do seu cliente.

O servidor local documentado abaixo ainda funciona e pode ser útil para configurações auto-hospedadas ou offline, mas o servidor hospedado é mais fácil e preferível.

---

Servidor auto-hospedado (local)

O restante deste documento aborda a execução do servidor Node.js local, que se comunica com a API Handwriting OCR usando um token de API.

Visão geral

O servidor MCP Handwriting OCR permite a integração entre clientes MCP e o serviço Handwriting OCR. Este documento descreve o processo de configuração e fornece um exemplo básico de uso do cliente.

Este servidor permite que você envie imagens e documentos PDF, verifique o status deles e recupere o resultado do OCR como Markdown.

Ferramentas

Transcrição

• Upload Document
• Check Status
• Get Text

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Node.js instalado no seu sistema (versão recomendada 18.x ou superior).
• Uma conta ativa na Plataforma Handwriting OCR e um token de API ativo.

Instalação

Instalando via Smithery

Para instalar o handwriting-ocr-mcp-server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @Handwriting-OCR/handwriting-ocr-mcp-server --client claude

Instalando manualmente para Claude Desktop

Para usar o servidor MCP Handwriting OCR no aplicativo Claude Desktop, use:

{
    "mcpServers": {
        "handwriting-ocr": {
            "command": "node",
            "args": [
                "/Users/mateo/Local/Code/MCP/handwriting-ocr/build/index.js"
            ],
            "env": {
                "API_TOKEN": "your-api-token",
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

Configuração

O servidor MCP Handwriting OCR suporta variáveis de ambiente para autenticação e configuração:

• API_TOKEN: Seu token de API.

Você pode encontrar esses valores no painel de configurações da API na Plataforma Handwriting OCR.

Suporte

Consulte a Documentação da API Handwriting OCR.

Para suporte com o servidor MCP Handwriting OCR, envie um GitHub Issue.

Sobre

Servidor Model Context Protocol (MCP) para a Plataforma Handwriting OCR