Skip to main content

Lathe — File & Media Processing MCP Server

Transforming raw files into precision output — the Swiss army knife for file processing.

License: Proprietary


What It Does

Lathe is an MCP server that gives AI assistants direct access to file and media processing operations. Install the free package for image processing, or purchase a license to unlock all 16 tools across four categories: image manipulation, PDF operations, audio/video processing, and OCR text extraction.


Free vs Full

Free Full (Licensed)
Image tools (6) Included Included
PDF tools (4) — Included
Audio/Video tools (4) — Included
OCR (1) — Included
Health + upgrade_info Included Health only
Total tools 8 16
Install pip install lathe-mcp Purchase at seayniclabs.com
Price Free $19 one-time

Tool Reference

Image (Free)

Tool Description Key Parameters
image_info Get image metadata (dimensions, format, mode, EXIF) input_path
image_resize Resize with aspect ratio preservation input_path, output_path, width, height, percentage
image_convert Convert format (png, jpeg, webp, avif, bmp) input_path, output_path, format
image_optimize Optimize for web delivery input_path, output_path, quality, strip_metadata
image_crop Crop a rectangular region input_path, output_path, x, y, width, height
image_thumbnail Generate a square-fit thumbnail input_path, output_path, size

PDF (Licensed)

Tool Description Key Parameters
pdf_info Get PDF metadata (pages, title, author, encryption) input_path
pdf_extract_text Extract text, with OCR fallback input_path, pages
pdf_merge Merge multiple PDFs into one input_paths, output_path
pdf_to_images Convert pages to images (requires ghostscript) input_path, output_dir, pages, format

Audio / Video (Licensed)

Tool Description Key Parameters
audio_convert Convert audio format (mp3, wav, flac, aac, ogg) input_path, output_path, format
audio_info Get audio metadata (duration, bitrate, sample rate) input_path
video_thumbnail Extract a frame from video as image input_path, output_path, timestamp
video_info Get video metadata (duration, resolution, codec) input_path

OCR (Licensed)

Tool Description Key Parameters
ocr_image Extract text from image via Tesseract input_path

Utility (Free)

Tool Description Key Parameters
health Server status, version, tier, dependency availability —
upgrade_info What the full version includes and where to buy (free tier only) —

Installation

Free install (image tools + health):

pip install lathe-mcp

Full install (all tools — requires license key):

pip install "lathe-mcp[full]"

Activating a License

After purchasing at seayniclabs.com, activate your license using either method:

Option 1: Environment variable

export LATHE_LICENSE_KEY="SL-XXXX-XXXX"

Option 2: License file

Place your license at ~/.seayniclabs/license.json:

{
  "key": "SL-XXXX-XXXX",
  "product": "lathe-mcp",
  "email": "you@example.com",
  "issued": "2026-01-01"
}

The health tool reports your current tier (free or licensed) and available tool count.

System Dependencies

Some tools require external binaries. Install only what you need:

Dependency Required For Install
ffmpeg Audio/video tools brew install ffmpeg / apt install ffmpeg
tesseract OCR tools brew install tesseract / apt install tesseract-ocr
ghostscript pdf_to_images brew install ghostscript / apt install ghostscript

The health tool reports which dependencies are available at runtime.


Usage

Run the server directly:

lathe

Or via the MCP CLI:

mcp run lathe

Claude Code

claude mcp add lathe -- /path/to/venv/bin/lathe

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "lathe": {
      "command": "/path/to/venv/bin/lathe",
      "env": {
        "LATHE_WORKING_DIR": "/path/to/allowed/directory"
      }
    }
  }
}

Configuration

Variable Description Default
LATHE_WORKING_DIR Root directory for all file operations Current working directory

All input and output paths are resolved relative to and constrained within LATHE_WORKING_DIR.


Security

  • Sandboxed file access — all paths validated against LATHE_WORKING_DIR
  • Path traversal protection — ../ and absolute paths outside the sandbox are rejected
  • Symlink escape detection — symlinks resolving outside the working directory are blocked
  • Decompression bomb guard — Pillow's built-in protections are active
  • File size limits — 500 MB maximum per input file

Development

git clone https://github.com/seayniclabs/lathe.git
cd lathe
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test,full]"
python -m pytest tests/ -q

Using with a Gateway

If you're running multiple MCP servers, route them through a gateway like tbxark/mcp-proxy to manage all child processes from a single persistent service. The proxy handles process lifecycle, centralized config, and crash recovery — each server still gets its own SSE endpoint but you manage everything from one config file instead of scattered Claude Code entries.

For a full walkthrough of how this works in practice, see The Hidden Cost of a Loaded MCP Stack on charlieseay.com.

License

Proprietary. Copyright (c) 2026 your organization LLC. All rights reserved.

See LICENSE for details.

Metadata

Release files for lathe-mcp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lathe-mcp 0.2.2
File Size Uploaded Provenance Actions
lathe_mcp-0.2.2.tar.gz 113.2 kB Without provenance Details for lathe_mcp-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lathe-mcp 0.2.2
File Interpreter ABI Platform Actions
lathe_mcp-0.2.2-py3-none-any.whl Python 3 none any Details for lathe_mcp-0.2.2-py3-none-any.whl

Total release size: 130.4 kB

Release files / lathe_mcp-0.2.2.tar.gz

Download URL lathe_mcp-0.2.2.tar.gz
Size 113.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f2bd4c5316a88c650a1da2ce36284255eafe48b3bd7f676f7b91118ebfd099d5
BLAKE2b-256 checksum
How to use checksums
b0568f2370ca6a73243c73b20f5b5d3ef3f343c37bc68e7369362bd883b2e667
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / lathe_mcp-0.2.2-py3-none-any.whl

Download URL lathe_mcp-0.2.2-py3-none-any.whl
Size 17.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7cb53ada9821b94f1e45c298327750abd34e464ee7c65bc888e527bfcdd93aec
BLAKE2b-256 checksum
How to use checksums
f03aafd64c78fa0f5b10abf0d83da20fd846f15f9b538efe445073282a3c2b9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for lathe-mcp 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page