lathe-mcp 0.1.0__tar.gz

lathe_mcp-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,45 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install external deps
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ffmpeg tesseract-ocr ghostscript
+
+      - name: Install Python deps
+        run: |
+          pip install -e ".[test]"
+          pip install pip-audit
+
+      - name: Generate test fixtures
+        run: python tests/generate_fixtures.py
+
+      - name: Run tests
+        run: pytest -v --cov=lathe --cov-report=xml --cov-fail-under=55
+
+      - name: Security audit
+        run: pip-audit
+
+      - name: Leakage scan
+        run: |
+          ! grep -ri "charlieseay\|seaynicroute\|192\.168\.0" src/ || (echo "LEAK DETECTED" && exit 1)
+
+      - name: Path traversal audit
+        run: |
+          ! grep -rn "os\.system\|subprocess\.call\|subprocess\.Popen.*shell=True" src/ || (echo "UNSAFE SHELL DETECTED" && exit 1)

lathe_mcp-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__
+*.pyc
+.venv/
+dist/
+*.egg-info
+.pytest_cache
+.coverage
+htmlcov/
+tests/fixtures/*.png
+tests/fixtures/*.jpg
+tests/fixtures/*.wav
+tests/fixtures/*.mp3
+tests/fixtures/*.mp4
+tests/fixtures/*.pdf

lathe_mcp-0.1.0/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) 2026 Seaynic Labs LLC. All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying, distribution,
+modification, or use of this software, via any medium, is strictly prohibited.
+
+A valid license is required for use. See https://seayniclabs.com for licensing terms.

lathe_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: lathe-mcp
+Version: 0.1.0
+Summary: File and media processing MCP server — resize, convert, optimize, extract.
+Project-URL: Homepage, https://seayniclabs.com
+Project-URL: Repository, https://github.com/seayniclabs/lathe
+Author-email: Charlie Seay <charlie@seayniclabs.com>
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Keywords: audio,file-processing,image,mcp,ocr,pdf,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.12
+Requires-Dist: httpx
+Requires-Dist: mcp[cli]
+Requires-Dist: pillow
+Provides-Extra: full
+Requires-Dist: ffmpeg-python; extra == 'full'
+Requires-Dist: pypdf; extra == 'full'
+Requires-Dist: pytesseract; extra == 'full'
+Provides-Extra: test
+Requires-Dist: pip-audit; extra == 'test'
+Requires-Dist: pypdf; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Lathe — File & Media Processing MCP Server
+
+Transforming raw files into precision output — the Swiss army knife for file processing.
+
+![License: Proprietary](https://img.shields.io/badge/license-proprietary-D97706)
+
+---
+
+## What It Does
+
+Lathe is an MCP server that gives AI assistants direct access to file and media processing operations. 16 tools across four categories handle the most common file transformation tasks: image manipulation, PDF operations, audio/video processing, and OCR text extraction.
+
+Install the core package for image processing, or install with extras to unlock PDF, media, and OCR capabilities.
+
+---
+
+## Tool Reference
+
+### Image
+
+| 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
+
+| 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
+
+| 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
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `ocr_image` | Extract text from image via Tesseract | `input_path` |
+
+### Utility
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `health` | Server status, version, dependency availability | — |
+
+---
+
+## Installation
+
+Core install (image tools only):
+
+```bash
+pip install lathe-mcp
+```
+
+Full install (PDF, audio/video, OCR):
+
+```bash
+pip install "lathe-mcp[full]"
+```
+
+### 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:
+
+```bash
+lathe
+```
+
+Or via the MCP CLI:
+
+```bash
+mcp run lathe
+```
+
+### Claude Code
+
+```bash
+claude mcp add lathe -- /path/to/venv/bin/lathe
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```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
+
+```bash
+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
+```
+
+---
+
+## License
+
+Proprietary. Copyright (c) 2026 Seaynic Labs LLC. All rights reserved.
+
+See [LICENSE](LICENSE) for details.

lathe_mcp-0.1.0/README.md

@@ -0,0 +1,165 @@
+# Lathe — File & Media Processing MCP Server
+
+Transforming raw files into precision output — the Swiss army knife for file processing.
+
+![License: Proprietary](https://img.shields.io/badge/license-proprietary-D97706)
+
+---
+
+## What It Does
+
+Lathe is an MCP server that gives AI assistants direct access to file and media processing operations. 16 tools across four categories handle the most common file transformation tasks: image manipulation, PDF operations, audio/video processing, and OCR text extraction.
+
+Install the core package for image processing, or install with extras to unlock PDF, media, and OCR capabilities.
+
+---
+
+## Tool Reference
+
+### Image
+
+| 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
+
+| 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
+
+| 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
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `ocr_image` | Extract text from image via Tesseract | `input_path` |
+
+### Utility
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `health` | Server status, version, dependency availability | — |
+
+---
+
+## Installation
+
+Core install (image tools only):
+
+```bash
+pip install lathe-mcp
+```
+
+Full install (PDF, audio/video, OCR):
+
+```bash
+pip install "lathe-mcp[full]"
+```
+
+### 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:
+
+```bash
+lathe
+```
+
+Or via the MCP CLI:
+
+```bash
+mcp run lathe
+```
+
+### Claude Code
+
+```bash
+claude mcp add lathe -- /path/to/venv/bin/lathe
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```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
+
+```bash
+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
+```
+
+---
+
+## License
+
+Proprietary. Copyright (c) 2026 Seaynic Labs LLC. All rights reserved.
+
+See [LICENSE](LICENSE) for details.

lathe_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lathe-mcp"
+version = "0.1.0"
+description = "File and media processing MCP server — resize, convert, optimize, extract."
+readme = "README.md"
+license = "LicenseRef-Proprietary"
+requires-python = ">=3.12"
+authors = [
+    { name = "Charlie Seay", email = "charlie@seayniclabs.com" },
+]
+keywords = ["mcp", "file-processing", "image", "pdf", "audio", "video", "ocr"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: Other/Proprietary License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Multimedia :: Sound/Audio :: Conversion",
+    "Topic :: Text Processing",
+]
+dependencies = [
+    "mcp[cli]",
+    "Pillow",
+    "httpx",
+]
+
+[project.urls]
+Homepage = "https://seayniclabs.com"
+Repository = "https://github.com/seayniclabs/lathe"
+
+[project.optional-dependencies]
+full = [
+    "ffmpeg-python",
+    "pytesseract",
+    "pypdf",
+]
+test = [
+    "pytest",
+    "pytest-cov",
+    "pip-audit",
+    "pypdf",
+]
+
+[project.scripts]
+lathe = "lathe.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lathe"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "requires_ffmpeg: test requires ffmpeg binary",
+    "requires_tesseract: test requires tesseract binary",
+    "requires_ghostscript: test requires ghostscript binary",
+]

lathe_mcp-0.1.0/src/lathe/__init__.py

@@ -0,0 +1,3 @@
+"""Lathe — file and media processing MCP server."""
+
+__version__ = "0.1.0"