MCP OCR Server

Un servidor MCP para el Reconocimiento Óptico de Caracteres (OCR) utilizando el motor Tesseract.

GitHub
39
Prueba este MCPPatrocinado

Documentación

MCP OCR Server

PyPI Downloads

Un servidor OCR de nivel de producción construido con MCP (Model Context Protocol) que proporciona capacidades de OCR a través de una interfaz sencilla.

Características

  • Extrae texto de imágenes usando Tesseract OCR
  • Soporte para múltiples tipos de entrada:
    • Archivos de imagen locales
    • URLs de imágenes
    • Bytes de imagen sin procesar
  • Instalación automática de Tesseract
  • Soporte para múltiples idiomas
  • Manejo de errores listo para producción

Instalación

# Using pip
pip install mcp-ocr

# Using uv
uv pip install mcp-ocr

Tesseract se instalará automáticamente en las plataformas compatibles:

  • macOS (mediante Homebrew)
  • Linux (mediante apt, dnf o pacman)
  • Windows (se proporcionan instrucciones de instalación manual)

Uso

Como servidor MCP

  1. Inicia el servidor:
python -m mcp_ocr
  1. Configura Claude para escritorio: Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:
{
    "mcpServers": {
        "ocr": {
            "command": "python",
            "args": ["-m", "mcp_ocr"]
        }
    }
}

Herramientas disponibles

perform_ocr

Extrae texto de imágenes:

# 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

Lista los idiomas de OCR disponibles:

get_supported_languages()

Desarrollo

  1. Clona el repositorio:
git clone https://github.com/rjn32s/mcp-ocr.git
cd mcp-ocr
  1. Configura el entorno de desarrollo:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .
  1. Ejecuta las pruebas:
pytest

Contribuciones

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Haz commit de tus cambios (git commit -m 'Add amazing feature')
  4. Sube los cambios a la rama (git push origin feature/amazing-feature)
  5. Abre un Pull Request

Seguridad

  • Nunca hagas commit de tokens de API o credenciales sensibles
  • Usa variables de entorno o almacenamiento seguro de credenciales
  • Sigue las mejores prácticas de seguridad de GitHub

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

Agradecimientos