MCP OCR Server

Um servidor MCP para Reconhecimento Óptico de Caracteres (OCR) usando o motor Tesseract.

GitHub
39

Documentação

MCP OCR Server

PyPI Downloads

Um servidor OCR de nível de produção construído usando MCP (Model Context Protocol) que fornece capacidades de OCR através de uma interface simples.

Recursos

  • Extrair texto de imagens usando Tesseract OCR
  • Suporte para múltiplos tipos de entrada:
    • Arquivos de imagem locais
    • URLs de imagens
    • Bytes brutos de imagem
  • Instalação automática do Tesseract
  • Suporte para múltiplos idiomas
  • Tratamento de erros pronto para produção

Instalação

# Using pip
pip install mcp-ocr

# Using uv
uv pip install mcp-ocr

O Tesseract será instalado automaticamente em plataformas suportadas:

  • macOS (via Homebrew)
  • Linux (via apt, dnf ou pacman)
  • Windows (instruções de instalação manual fornecidas)

Uso

Como um Servidor MCP

  1. Inicie o servidor:
python -m mcp_ocr
  1. Configure o Claude for Desktop: Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:
{
    "mcpServers": {
        "ocr": {
            "command": "python",
            "args": ["-m", "mcp_ocr"]
        }
    }
}

Ferramentas Disponíveis

perform_ocr

Extraia texto de imagens:

# From file
perform_ocr("/path/to/image.jpg")

# From URL
perform_ocr("https://example.com/image.jpg")

# From bytes
perform_ocr(image_bytes)

get_supported_languages

Liste os idiomas de OCR disponíveis:

get_supported_languages()

Desenvolvimento

  1. Clone o repositório:
git clone https://github.com/rjn32s/mcp-ocr.git
cd mcp-ocr
  1. Configure o ambiente de desenvolvimento:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .
  1. Execute os testes:
pytest

Contribuindo

  1. Faça um fork do repositório
  2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Segurança

  • Nunca faça commit de tokens de API ou credenciais sensíveis
  • Use variáveis de ambiente ou armazenamento seguro de credenciais
  • Siga as melhores práticas de segurança do GitHub

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos