@mcptoolshop/toolshopstudio 1.2.0-toolshop → 1.3.0-toolshop

package/.github/workflows/ci.yml

@@ -23,7 +23,7 @@ concurrency:
 
 jobs:
   test:
-    name: Typecheck + Test + Smoke (FFmpeg + Pandoc + FreeCAD)
+    name: Typecheck + Test + Smoke (FFmpeg + Pandoc + FreeCAD + GDAL)
     runs-on: ubuntu-latest
 
     strategy:
@@ -43,11 +43,11 @@ jobs:
       - name: Typecheck
         run: npm run typecheck
 
-      - name: Unit tests (FFmpeg + Pandoc + FreeCAD)
+      - name: Unit tests (FFmpeg + Pandoc + FreeCAD + GDAL)
         run: npm test
 
       - name: Build
         run: npm run build
 
-      - name: Smoke test (all three tools)
+      - name: Smoke test (all four tools)
         run: npm run smoke

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.3.0-toolshop] - 2026-02-19
+
+### Added
+- **GDAL MCP**: full geospatial transform tool (5 presets: raster-wgs84-tiff, vector-geojson, raster-to-png, vector-shapefile, clip-raster)
+- GDAL multi-binary dispatch: gdalwarp, ogr2ogr, gdal_translate selected per preset
+- GDAL two-tier encoding: premium clip-raster with automatic fallback to raster-wgs84-tiff
+- GDAL schema-first design: Zod schemas for TransformGeo, GDALGeoDataAsset, quality tiers
+- buildGDALArgs pure function (deterministic $INPUT/$OUTPUT/$BBOX substitution)
+- GDAL dual-mode progress parser (direct percent + step-counting fallback)
+- GDAL pre/post-flight assertions (input validation, format compatibility, suspicious expansion detection)
+- GDAL context DI pattern (TransformGeoContext) matching FreeCAD/Pandoc/FFmpeg
+- GDALGeoDataCRUD with lazy hydration + optional JSON persistence
+- GDAL output polish (auto-extension, typed output metadata, configurable expiry)
+- Docker image now includes gdal-bin for geospatial transforms
+- Quad-tool smoke test (FFmpeg + Pandoc + FreeCAD + GDAL, 10 end-to-end tests)
+- 114 unit/integration tests (13 FFmpeg + 29 Pandoc + 33 FreeCAD + 39 GDAL)
+
+### Changed
+- Multilingual README: EN + 7 translations (JA, ZH, ES, FR, HI, IT, PT-BR)
+- Docker image relabeled for v1.3.0-toolshop
+- CI labels updated for all four tools
+
+---
+
 ## [1.2.0-toolshop] - 2026-02-19
 
 ### Added

package/Dockerfile

@@ -12,15 +12,17 @@ RUN npm run build
 # ── Production stage ───────────────────────────────────────────────
 FROM node:22-slim
 
-# Install all three runtime binaries
-# ffmpeg:     video transcoding (FFmpeg YouTube MCP)
-# pandoc:     document conversion (Pandoc MCP)
+# Install all four runtime binaries
+# ffmpeg:      video transcoding (FFmpeg YouTube MCP)
+# pandoc:      document conversion (Pandoc MCP)
 # freecad-cmd: headless CAD export (FreeCAD MCP) — no GUI deps
+# gdal-bin:    geospatial transforms (GDAL MCP) — gdalwarp, ogr2ogr, gdal_translate
 RUN apt-get update && \
     apt-get install -y --no-install-recommends \
       ffmpeg \
       pandoc \
       freecad-cmd \
+      gdal-bin \
     && rm -rf /var/lib/apt/lists/*
 
 WORKDIR /app
@@ -43,8 +45,8 @@ ENV NODE_ENV=production
 VOLUME ["/sandbox", "/tmp/toolshop"]
 
 LABEL org.opencontainers.image.title="ToolShopStudio" \
-      org.opencontainers.image.description="FFmpeg YouTube + Pandoc + FreeCAD MCP tools — triple-tool kit for ordinary creators" \
-      org.opencontainers.image.version="1.2.0-toolshop" \
+      org.opencontainers.image.description="FFmpeg YouTube + Pandoc + FreeCAD + GDAL MCP tools — quad-tool kit for ordinary creators" \
+      org.opencontainers.image.version="1.3.0-toolshop" \
       org.opencontainers.image.logo="assets/logo.png" \
       org.opencontainers.image.source="https://github.com/mcp-tool-shop-org/ToolShopStudio" \
       org.opencontainers.image.licenses="MIT"

package/README.es.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="assets/logo.png" width="400" alt="ToolShopStudio">
+</p>
+
+<h1 align="center">ToolShopStudio</h1>
+
+<p align="center">
+  Una sola instalacion. Cuatro herramientas MCP de produccion para creadores.
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.zh.md">中文</a> |
+  <strong>Español</strong> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.hi.md">हिन्दी</a> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions"><img src="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/toolshopstudio"><img src="https://img.shields.io/npm/v/@mcptoolshop/toolshopstudio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/tools-FFmpeg%20%2B%20Pandoc%20%2B%20FreeCAD%20%2B%20GDAL-orange" alt="Tools">
+  <img src="https://img.shields.io/badge/tests-114%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
+</p>
+
+---
+
+## Herramientas Incluidas
+
+| Herramienta | Funcion |
+|-------------|---------|
+| **FFmpeg YouTube MCP** | Presets seguros para YouTube (garantizado + premium con fallback), GOP cerrado, miniaturas duales |
+| **Pandoc MCP** | Conversion de documentos sin flags: blog, PDF academico, ebook, slides, newsletter |
+| **FreeCAD MCP** | Exportacion 3D CAD segura: STL, STEP, GLB, 3MF, OBJ — sin interfaz, sin codigo de usuario |
+| **GDAL MCP** | Transformaciones geoespaciales: reproyeccion raster, conversion vectorial, recorte de regiones — el FFmpeg del GIS |
+
+Las cuatro herramientas comparten la misma superficie: **schema-first, sandbox, observable, DI por contexto, cero argumentos crudos**.
+
+## Inicio Rapido
+
+```bash
+npm install @mcptoolshop/toolshopstudio
+```
+
+```typescript
+import {
+  transcodeForYouTube,
+  createInMemoryCRUD,
+  pandoc,
+  freecad,
+  gdal,
+} from "@mcptoolshop/toolshopstudio";
+
+// ── FFmpeg: transcodificacion segura para YouTube ───────────────
+const video = await transcodeForYouTube(
+  { inputPath: "input.mp4", outputPath: "output.mp4", preset: "yt-1080p-h264" },
+  { signal, userId, notify, createAsset, runFfmpeg, runProbe },
+);
+
+// ── Pandoc: conversion de documentos ────────────────────────────
+const doc = await pandoc.convertDocument(
+  { inputPath: "thesis.md", outputPath: "thesis.pdf", preset: "academic-pdf" },
+  { signal, userId, notify, createAsset, runPandoc, checkInput, assertOutput, statFile },
+);
+
+// ── FreeCAD: exportacion 3D CAD ─────────────────────────────────
+const part = await freecad.exportPart(
+  { inputPath: "bracket.FCStd", outputPath: "bracket.stl", preset: "stl-print-ready" },
+  { signal, userId, notify, createAsset, runFreeCAD, checkInput, assertOutput, statFile },
+);
+
+// ── GDAL: transformacion geoespacial ────────────────────────────
+const geo = await gdal.transformGeo(
+  { inputPath: "terrain.tif", outputPath: "terrain_wgs84.tif", preset: "raster-wgs84-tiff" },
+  { signal, userId, notify, createAsset, runGDAL, checkInput, assertOutput, statFile },
+);
+```
+
+## Arquitectura
+
+- **Schema-first**: Esquemas Zod para cada entrada/salida, totalmente tipado
+- **Context DI**: Todos los efectos secundarios inyectados via objetos de contexto, 100% mockeable
+- **Aislamiento sandbox**: Prevencion de path traversal en cada operacion de archivo
+- **Observable**: Notificaciones tipadas (progreso, advertencias, listo) en cada etapa
+- **Cancelacion**: AbortController propagado a cada checkpoint del pipeline
+- **Fallback**: Los presets premium degradan automaticamente a garantizado en caso de fallo
+- **Ejecucion segura**: FreeCAD usa one-liners Python preconstruidos (sin exec/eval/codigo de usuario)
+- **Multi-binario**: GDAL despacha a gdalwarp, ogr2ogr o gdal_translate segun el preset
+
+## Docker
+
+```bash
+docker build -t toolshopstudio .
+docker run -v ./sandbox:/sandbox toolshopstudio
+```
+
+Los cuatro binarios (`ffmpeg`, `pandoc`, `freecad-cmd`, `gdal-bin`) vienen preinstalados en la imagen.
+
+## Desarrollo
+
+```bash
+npm install          # dependencias
+npm run typecheck    # tsc --noEmit
+npm test             # vitest (114 tests)
+npm run build        # compilar a dist/
+npm run smoke        # smoke end-to-end (4 herramientas, 10 tests)
+```
+
+## Licencia
+
+MIT

package/README.fr.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="assets/logo.png" width="400" alt="ToolShopStudio">
+</p>
+
+<h1 align="center">ToolShopStudio</h1>
+
+<p align="center">
+  Une seule installation. Quatre outils MCP de production pour les createurs.
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.es.md">Español</a> |
+  <strong>Français</strong> |
+  <a href="README.hi.md">हिन्दी</a> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions"><img src="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/toolshopstudio"><img src="https://img.shields.io/npm/v/@mcptoolshop/toolshopstudio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/tools-FFmpeg%20%2B%20Pandoc%20%2B%20FreeCAD%20%2B%20GDAL-orange" alt="Tools">
+  <img src="https://img.shields.io/badge/tests-114%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
+</p>
+
+---
+
+## Outils Inclus
+
+| Outil | Fonction |
+|-------|----------|
+| **FFmpeg YouTube MCP** | Presets YouTube (garanti + premium avec fallback), GOP ferme, double miniature |
+| **Pandoc MCP** | Conversion de documents sans flags : blog, PDF academique, ebook, slides, newsletter |
+| **FreeCAD MCP** | Export 3D CAD securise : STL, STEP, GLB, 3MF, OBJ — headless, sans code utilisateur |
+| **GDAL MCP** | Transformations geospatiales : reprojection raster, conversion vectorielle, decoupage de regions — le FFmpeg du SIG |
+
+Les quatre outils partagent la meme surface : **schema-first, sandbox, observable, DI par contexte, zero arguments bruts**.
+
+## Demarrage Rapide
+
+```bash
+npm install @mcptoolshop/toolshopstudio
+```
+
+```typescript
+import {
+  transcodeForYouTube,
+  createInMemoryCRUD,
+  pandoc,
+  freecad,
+  gdal,
+} from "@mcptoolshop/toolshopstudio";
+
+// ── FFmpeg : transcodage YouTube ────────────────────────────────
+const video = await transcodeForYouTube(
+  { inputPath: "input.mp4", outputPath: "output.mp4", preset: "yt-1080p-h264" },
+  { signal, userId, notify, createAsset, runFfmpeg, runProbe },
+);
+
+// ── Pandoc : conversion de documents ────────────────────────────
+const doc = await pandoc.convertDocument(
+  { inputPath: "thesis.md", outputPath: "thesis.pdf", preset: "academic-pdf" },
+  { signal, userId, notify, createAsset, runPandoc, checkInput, assertOutput, statFile },
+);
+
+// ── FreeCAD : export 3D CAD ─────────────────────────────────────
+const part = await freecad.exportPart(
+  { inputPath: "bracket.FCStd", outputPath: "bracket.stl", preset: "stl-print-ready" },
+  { signal, userId, notify, createAsset, runFreeCAD, checkInput, assertOutput, statFile },
+);
+
+// ── GDAL : transformation geospatiale ───────────────────────────
+const geo = await gdal.transformGeo(
+  { inputPath: "terrain.tif", outputPath: "terrain_wgs84.tif", preset: "raster-wgs84-tiff" },
+  { signal, userId, notify, createAsset, runGDAL, checkInput, assertOutput, statFile },
+);
+```
+
+## Architecture
+
+- **Schema-first** : Schemas Zod pour chaque entree/sortie, entierement type
+- **Context DI** : Tous les effets de bord injectes via des objets de contexte, 100% mockable
+- **Isolation sandbox** : Prevention de path traversal sur chaque operation fichier
+- **Observable** : Notifications typees (progression, avertissements, pret) a chaque etape
+- **Annulation** : AbortController propage a chaque checkpoint du pipeline
+- **Fallback** : Les presets premium se degradent automatiquement en garanti en cas d'echec
+- **Execution securisee** : FreeCAD utilise des one-liners Python preconstruits (pas d'exec/eval/code utilisateur)
+- **Multi-binaire** : GDAL dispatche vers gdalwarp, ogr2ogr ou gdal_translate selon le preset
+
+## Docker
+
+```bash
+docker build -t toolshopstudio .
+docker run -v ./sandbox:/sandbox toolshopstudio
+```
+
+Les quatre binaires (`ffmpeg`, `pandoc`, `freecad-cmd`, `gdal-bin`) sont preinstalles dans l'image.
+
+## Developpement
+
+```bash
+npm install          # dependances
+npm run typecheck    # tsc --noEmit
+npm test             # vitest (114 tests)
+npm run build        # compiler vers dist/
+npm run smoke        # smoke end-to-end (4 outils, 10 tests)
+```
+
+## Licence
+
+MIT

package/README.hi.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="assets/logo.png" width="400" alt="ToolShopStudio">
+</p>
+
+<h1 align="center">ToolShopStudio</h1>
+
+<p align="center">
+  एक इंस्टॉल। क्रिएटर्स के लिए चार प्रोडक्शन-ग्रेड MCP टूल्स।
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.fr.md">Français</a> |
+  <strong>हिन्दी</strong> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions"><img src="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/toolshopstudio"><img src="https://img.shields.io/npm/v/@mcptoolshop/toolshopstudio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/tools-FFmpeg%20%2B%20Pandoc%20%2B%20FreeCAD%20%2B%20GDAL-orange" alt="Tools">
+  <img src="https://img.shields.io/badge/tests-114%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
+</p>
+
+---
+
+## शामिल टूल्स
+
+| टूल | कार्य |
+|------|-------|
+| **FFmpeg YouTube MCP** | YouTube-सुरक्षित प्रीसेट (गारंटीड + प्रीमियम ऑटो-फ़ॉलबैक), क्लोज़्ड-GOP, दोहरे थंबनेल |
+| **Pandoc MCP** | ज़ीरो-फ़्लैग डॉक्यूमेंट कन्वर्ज़न: ब्लॉग, एकेडमिक PDF, ebook, स्लाइड्स, न्यूज़लेटर |
+| **FreeCAD MCP** | सुरक्षित 3D CAD एक्सपोर्ट: STL, STEP, GLB, 3MF, OBJ — हेडलेस, यूज़र कोड नहीं |
+| **GDAL MCP** | भू-स्थानिक ट्रांसफ़ॉर्म: रैस्टर री-प्रोजेक्शन, वेक्टर कन्वर्ज़न, रीजन क्लिप — GIS का FFmpeg |
+
+चारों टूल्स एक ही डिज़ाइन साझा करते हैं: **स्कीमा-फ़र्स्ट, सैंडबॉक्स्ड, ऑब्ज़र्वेबल, कॉन्टेक्स्ट DI, ज़ीरो रॉ आर्ग्स**।
+
+## त्वरित शुरुआत
+
+```bash
+npm install @mcptoolshop/toolshopstudio
+```
+
+```typescript
+import {
+  transcodeForYouTube,
+  createInMemoryCRUD,
+  pandoc,
+  freecad,
+  gdal,
+} from "@mcptoolshop/toolshopstudio";
+
+// ── FFmpeg: YouTube-सुरक्षित ट्रांसकोड ─────────────────────────
+const video = await transcodeForYouTube(
+  { inputPath: "input.mp4", outputPath: "output.mp4", preset: "yt-1080p-h264" },
+  { signal, userId, notify, createAsset, runFfmpeg, runProbe },
+);
+
+// ── Pandoc: डॉक्यूमेंट कन्वर्ज़न ───────────────────────────────
+const doc = await pandoc.convertDocument(
+  { inputPath: "thesis.md", outputPath: "thesis.pdf", preset: "academic-pdf" },
+  { signal, userId, notify, createAsset, runPandoc, checkInput, assertOutput, statFile },
+);
+
+// ── FreeCAD: 3D CAD एक्सपोर्ट ──────────────────────────────────
+const part = await freecad.exportPart(
+  { inputPath: "bracket.FCStd", outputPath: "bracket.stl", preset: "stl-print-ready" },
+  { signal, userId, notify, createAsset, runFreeCAD, checkInput, assertOutput, statFile },
+);
+
+// ── GDAL: भू-स्थानिक ट्रांसफ़ॉर्म ──────────────────────────────
+const geo = await gdal.transformGeo(
+  { inputPath: "terrain.tif", outputPath: "terrain_wgs84.tif", preset: "raster-wgs84-tiff" },
+  { signal, userId, notify, createAsset, runGDAL, checkInput, assertOutput, statFile },
+);
+```
+
+## आर्किटेक्चर
+
+- **स्कीमा-फ़र्स्ट**: हर इनपुट/आउटपुट के लिए Zod स्कीमा, पूर्ण टाइप-सेफ़
+- **कॉन्टेक्स्ट DI**: सभी साइड इफ़ेक्ट्स कॉन्टेक्स्ट ऑब्जेक्ट्स से इंजेक्ट, 100% मॉक करने योग्य
+- **सैंडबॉक्स आइसोलेशन**: हर फ़ाइल ऑपरेशन पर पाथ ट्रैवर्सल रोकथाम
+- **ऑब्ज़र्वेबल**: हर स्टेज पर टाइप्ड नोटिफ़िकेशन (प्रगति, चेतावनी, तैयार)
+- **रद्दीकरण**: AbortController हर पाइपलाइन चेकपॉइंट तक प्रसारित
+- **फ़ॉलबैक**: प्रीमियम प्रीसेट विफलता पर गारंटीड में स्वचालित डिग्रेड
+- **सुरक्षित निष्पादन**: FreeCAD पूर्व-निर्मित Python वन-लाइनर्स का उपयोग करता है (कोई exec/eval/यूज़र कोड नहीं)
+- **मल्टी-बाइनरी**: GDAL प्रीसेट के अनुसार gdalwarp, ogr2ogr या gdal_translate को डिस्पैच करता है
+
+## Docker
+
+```bash
+docker build -t toolshopstudio .
+docker run -v ./sandbox:/sandbox toolshopstudio
+```
+
+चारों रनटाइम बाइनरी (`ffmpeg`, `pandoc`, `freecad-cmd`, `gdal-bin`) इमेज में प्री-इंस्टॉल्ड हैं।
+
+## विकास
+
+```bash
+npm install          # डिपेंडेंसी
+npm run typecheck    # tsc --noEmit
+npm test             # vitest (114 टेस्ट)
+npm run build        # dist/ में कंपाइल
+npm run smoke        # एंड-टू-एंड स्मोक (4 टूल्स, 10 टेस्ट)
+```
+
+## लाइसेंस
+
+MIT

package/README.it.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="assets/logo.png" width="400" alt="ToolShopStudio">
+</p>
+
+<h1 align="center">ToolShopStudio</h1>
+
+<p align="center">
+  Un'unica installazione. Quattro strumenti MCP di produzione per creatori.
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.hi.md">हिन्दी</a> |
+  <strong>Italiano</strong> |
+  <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions"><img src="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/toolshopstudio"><img src="https://img.shields.io/npm/v/@mcptoolshop/toolshopstudio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/tools-FFmpeg%20%2B%20Pandoc%20%2B%20FreeCAD%20%2B%20GDAL-orange" alt="Tools">
+  <img src="https://img.shields.io/badge/tests-114%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
+</p>
+
+---
+
+## Strumenti Inclusi
+
+| Strumento | Funzione |
+|-----------|----------|
+| **FFmpeg YouTube MCP** | Preset sicuri per YouTube (garantito + premium con fallback), GOP chiuso, doppia miniatura |
+| **Pandoc MCP** | Conversione documenti senza flag: blog, PDF accademico, ebook, slide, newsletter |
+| **FreeCAD MCP** | Esportazione 3D CAD sicura: STL, STEP, GLB, 3MF, OBJ — headless, nessun codice utente |
+| **GDAL MCP** | Trasformazioni geospaziali: riproiezione raster, conversione vettoriale, ritaglio regioni — l'FFmpeg del GIS |
+
+Tutti e quattro gli strumenti condividono la stessa superficie: **schema-first, sandbox, osservabile, DI per contesto, zero argomenti grezzi**.
+
+## Avvio Rapido
+
+```bash
+npm install @mcptoolshop/toolshopstudio
+```
+
+```typescript
+import {
+  transcodeForYouTube,
+  createInMemoryCRUD,
+  pandoc,
+  freecad,
+  gdal,
+} from "@mcptoolshop/toolshopstudio";
+
+// ── FFmpeg: transcodifica sicura per YouTube ────────────────────
+const video = await transcodeForYouTube(
+  { inputPath: "input.mp4", outputPath: "output.mp4", preset: "yt-1080p-h264" },
+  { signal, userId, notify, createAsset, runFfmpeg, runProbe },
+);
+
+// ── Pandoc: conversione documenti ───────────────────────────────
+const doc = await pandoc.convertDocument(
+  { inputPath: "thesis.md", outputPath: "thesis.pdf", preset: "academic-pdf" },
+  { signal, userId, notify, createAsset, runPandoc, checkInput, assertOutput, statFile },
+);
+
+// ── FreeCAD: esportazione 3D CAD ────────────────────────────────
+const part = await freecad.exportPart(
+  { inputPath: "bracket.FCStd", outputPath: "bracket.stl", preset: "stl-print-ready" },
+  { signal, userId, notify, createAsset, runFreeCAD, checkInput, assertOutput, statFile },
+);
+
+// ── GDAL: trasformazione geospaziale ────────────────────────────
+const geo = await gdal.transformGeo(
+  { inputPath: "terrain.tif", outputPath: "terrain_wgs84.tif", preset: "raster-wgs84-tiff" },
+  { signal, userId, notify, createAsset, runGDAL, checkInput, assertOutput, statFile },
+);
+```
+
+## Architettura
+
+- **Schema-first**: Schemi Zod per ogni input/output, completamente tipizzato
+- **Context DI**: Tutti gli effetti collaterali iniettati tramite oggetti di contesto, 100% mockabile
+- **Isolamento sandbox**: Prevenzione path traversal su ogni operazione file
+- **Osservabile**: Notifiche tipizzate (progresso, avvertimenti, pronto) ad ogni fase
+- **Cancellazione**: AbortController propagato ad ogni checkpoint della pipeline
+- **Fallback**: I preset premium degradano automaticamente a garantito in caso di errore
+- **Esecuzione sicura**: FreeCAD usa one-liner Python precostituiti (nessun exec/eval/codice utente)
+- **Multi-binario**: GDAL dispatcha verso gdalwarp, ogr2ogr o gdal_translate in base al preset
+
+## Docker
+
+```bash
+docker build -t toolshopstudio .
+docker run -v ./sandbox:/sandbox toolshopstudio
+```
+
+Tutti e quattro i binari (`ffmpeg`, `pandoc`, `freecad-cmd`, `gdal-bin`) sono preinstallati nell'immagine.
+
+## Sviluppo
+
+```bash
+npm install          # dipendenze
+npm run typecheck    # tsc --noEmit
+npm test             # vitest (114 test)
+npm run build        # compilare in dist/
+npm run smoke        # smoke end-to-end (4 strumenti, 10 test)
+```
+
+## Licenza
+
+MIT

package/README.ja.md

@@ -0,0 +1,115 @@
+<p align="center">
+  <img src="assets/logo.png" width="400" alt="ToolShopStudio">
+</p>
+
+<h1 align="center">ToolShopStudio</h1>
+
+<p align="center">
+  1回のインストールで、クリエイター向け本番グレードMCPツール4本。
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <strong>日本語</strong> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.hi.md">हिन्दी</a> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.pt-BR.md">Português</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions"><img src="https://github.com/mcp-tool-shop-org/ToolShopStudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/toolshopstudio"><img src="https://img.shields.io/npm/v/@mcptoolshop/toolshopstudio" alt="npm version"></a>
+  <img src="https://img.shields.io/badge/tools-FFmpeg%20%2B%20Pandoc%20%2B%20FreeCAD%20%2B%20GDAL-orange" alt="Tools">
+  <img src="https://img.shields.io/badge/tests-114%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
+</p>
+
+---
+
+## 搭載ツール
+
+| ツール | 機能 |
+|--------|------|
+| **FFmpeg YouTube MCP** | YouTube安全プリセット（保証+プレミアム自動フォールバック）、クローズドGOP、デュアルサムネイル |
+| **Pandoc MCP** | フラグ不要のドキュメント変換：ブログ、学術PDF、電子書籍、スライド、ニュースレター |
+| **FreeCAD MCP** | 安全な3D CADエクスポート：STL, STEP, GLB, 3MF, OBJ — ヘッドレス、ユーザーコード不要 |
+| **GDAL MCP** | 地理空間変換：ラスター再投影、ベクター変換、領域クリップ — GISのFFmpeg |
+
+4つのツールすべてが同じ設計原則を共有：**スキーマファースト、サンドボックス化、監視可能、コンテキストDI、生引数なし**。
+
+## クイックスタート
+
+```bash
+npm install @mcptoolshop/toolshopstudio
+```
+
+```typescript
+import {
+  transcodeForYouTube,
+  createInMemoryCRUD,
+  pandoc,
+  freecad,
+  gdal,
+} from "@mcptoolshop/toolshopstudio";
+
+// ── FFmpeg: YouTube安全トランスコード ──────────────────────────
+const video = await transcodeForYouTube(
+  { inputPath: "input.mp4", outputPath: "output.mp4", preset: "yt-1080p-h264" },
+  { signal, userId, notify, createAsset, runFfmpeg, runProbe },
+);
+
+// ── Pandoc: ドキュメント変換 ─────────────────────────────────────
+const doc = await pandoc.convertDocument(
+  { inputPath: "thesis.md", outputPath: "thesis.pdf", preset: "academic-pdf" },
+  { signal, userId, notify, createAsset, runPandoc, checkInput, assertOutput, statFile },
+);
+
+// ── FreeCAD: 3D CADエクスポート ──────────────────────────────────
+const part = await freecad.exportPart(
+  { inputPath: "bracket.FCStd", outputPath: "bracket.stl", preset: "stl-print-ready" },
+  { signal, userId, notify, createAsset, runFreeCAD, checkInput, assertOutput, statFile },
+);
+
+// ── GDAL: 地理空間変換 ──────────────────────────────────────────
+const geo = await gdal.transformGeo(
+  { inputPath: "terrain.tif", outputPath: "terrain_wgs84.tif", preset: "raster-wgs84-tiff" },
+  { signal, userId, notify, createAsset, runGDAL, checkInput, assertOutput, statFile },
+);
+```
+
+## アーキテクチャ
+
+- **スキーマファースト**: すべての入出力にZodスキーマ、完全な型安全性
+- **コンテキストDI**: すべての副作用をコンテキストオブジェクトで注入、100%モック可能
+- **サンドボックス分離**: すべてのファイル操作でパストラバーサル防止
+- **監視可能**: すべてのステージで型付き通知（進捗、警告、完了）
+- **キャンセル対応**: AbortControllerをパイプラインの全チェックポイントに伝播
+- **フォールバック**: プレミアムプリセットは失敗時に保証プリセットに自動降格
+- **安全な実行**: FreeCADは事前構築されたPythonワンライナーを使用（exec/eval/ユーザーコードなし）
+- **マルチバイナリ**: GDALはプリセットごとにgdalwarp, ogr2ogr, gdal_translateに振り分け
+
+## Docker
+
+```bash
+docker build -t toolshopstudio .
+docker run -v ./sandbox:/sandbox toolshopstudio
+```
+
+4つのランタイムバイナリ（`ffmpeg`, `pandoc`, `freecad-cmd`, `gdal-bin`）がイメージにプリインストール済み。
+
+## 開発
+
+```bash
+npm install          # 依存関係
+npm run typecheck    # tsc --noEmit
+npm test             # vitest（114テスト）
+npm run build        # dist/にコンパイル
+npm run smoke        # エンドツーエンドスモーク（4ツール全10テスト）
+```
+
+## ライセンス
+
+MIT