@pinepaper.studio/mcp-server 1.5.5 → 1.6.1

package/README.de.md

@@ -0,0 +1,71 @@
+# PinePaper MCP-Server
+
+> Animierte Vektorgrafiken mit KI erstellen — über das Model Context Protocol
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · **Deutsch** · [हिन्दी](README.hi.md)
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — animierte Grafiken aus Tool-Aufrufen" width="840">
+</p>
+
+*Das Banner oben ist ein animiertes SVG, direkt aus PinePaper-Tool-Aufrufen exportiert — kein Video, kein GIF. Auf GitHub öffnen und zusehen, wie es sich bewegt.*
+
+## Überblick
+
+Der PinePaper MCP-Server lässt KI-Assistenten über das Model Context Protocol Grafiken in [PinePaper Studio](https://pinepaper.studio) erstellen und animieren. Funktioniert mit jeder KI, die MCP-Tool-Aufrufe unterstützt (Claude, GPT, Gemini, lokale Modelle usw.).
+
+Der Server bietet **121 Tools**: Zeichnen, Animation, Diagramme, Karten, Typografie, Physik, Bildbearbeitung, Datenvisualisierung und Export:
+
+- Text, Formen, Geometrie und komplexe Grafiken erstellen
+- Mit deklarativen **Relationen** animieren statt mit Keyframes
+- Prozedurale Hintergründe und gleichungsbasierte Pfade
+- Diagramme, Karten, Charts und Buchstaben-Collagen
+- Bildbearbeitung: Zuschneiden, Chroma-Key (Greenscreen entfernen), GPU-Filter, Lasso-Ausschnitte, Objekterkennung
+- Export als animiertes SVG, Videoframes, einbettbare Widgets und LLM-Trainingsdaten
+
+## Schnellstart
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+Bitten Sie Ihre KI zum Beispiel:
+
+> „Erstelle einen roten, pulsierenden HELLO-Text"
+
+> „Erstelle Sonne und Erde, und lass die Erde um die Sonne kreisen"
+
+> „Füge einen Sunburst-Hintergrund in Blau und Violett hinzu"
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="Rotierendes Sunburst-Poster">
+  <img src="assets/easing-splashes.svg" width="300" alt="Gestaffelt hüpfende Splash-Formen">
+  <img src="assets/live-badge.svg" width="180" alt="Blinkendes LIVE-Badge">
+</p>
+
+## Neu in 1.6.0
+
+- **Bildbearbeitungs-Tools**: `pinepaper_crop_image` (Ein-Schritt-Zuschnitt, behält Id und Relationen) und `pinepaper_chroma_key` (Chroma-Key mit automatisch geschätztem Schwellwert)
+- **`pinepaper_media` erhält `set_clip`** — bereits hochgeladene Clips neu trimmen
+- **Shader-Auren** in `pinepaper_apply_effect`: `heatmap`, `liquid_metal`, `gem_smoke`
+- **`pinepaper_image_filter` repariert und erweitert** — an die echte GPU-Filter-Engine angebunden, alle 15 Filter (Halbton-Familie, Posterisieren, Vignette, HSL, Dithering …)
+- **README als MCP-Ressource** — Clients können `pinepaper://docs/readme` (mit Sprachvarianten) direkt im Protokoll lesen
+
+## Mehr
+
+Die vollständige Tool-Referenz, Toolkits und Token-Budget sowie die Relationsliste stehen im [englischen README](README.md). Der kanonische Agenten-Workflow liegt in der Ressource `pinepaper://docs/agent-guide`.
+
+MIT-Lizenz · [pinepaper.studio](https://pinepaper.studio)

package/README.es.md

@@ -0,0 +1,71 @@
+# Servidor MCP de PinePaper
+
+> Crea gráficos vectoriales animados con IA mediante el Model Context Protocol
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · **Español** · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — gráficos animados hechos con llamadas a herramientas" width="840">
+</p>
+
+*El banner de arriba es un SVG animado, exportado directamente desde llamadas a herramientas de PinePaper — sin vídeo, sin GIF. Ábrelo en GitHub y míralo moverse.*
+
+## Descripción
+
+El servidor MCP de PinePaper permite a los asistentes de IA crear y animar gráficos en [PinePaper Studio](https://pinepaper.studio) a través del Model Context Protocol. Funciona con cualquier IA que soporte llamadas a herramientas MCP (Claude, GPT, Gemini, modelos locales, etc.).
+
+Expone **121 herramientas**: dibujo, animación, diagramas, mapas, tipografía, física, edición de imágenes, visualización de datos y exportación:
+
+- Crear texto, formas, geometría y gráficos complejos
+- Animar con **relaciones** declarativas en lugar de fotogramas clave
+- Fondos procedurales y trayectorias definidas por ecuaciones
+- Diagramas, mapas, gráficas y collages de letras
+- Edición de imágenes: recorte, croma (quitar fondo verde), filtros GPU, recorte con lazo, detección de objetos
+- Exportar SVG animado, fotogramas de vídeo, widgets embebibles y datos de entrenamiento para LLM
+
+## Inicio rápido
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+Prueba a pedirle a tu IA:
+
+> «Crea un texto HELLO rojo con animación de pulso»
+
+> «Crea un sol y una tierra, y haz que la tierra orbite el sol»
+
+> «Añade un fondo de rayos de sol en azul y morado»
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="Cartel de sol giratorio">
+  <img src="assets/easing-splashes.svg" width="300" alt="Formas que rebotan escalonadas">
+  <img src="assets/live-badge.svg" width="180" alt="Insignia LIVE parpadeante">
+</p>
+
+## Novedades de la 1.6.0
+
+- **Herramientas de edición de imagen**: `pinepaper_crop_image` (recorte en un paso, conserva el id y las relaciones) y `pinepaper_chroma_key` (croma con umbral autoestimado)
+- **`pinepaper_media` añade `set_clip`** — reajusta el recorte de un clip ya subido
+- **Auras de shader** en `pinepaper_apply_effect`: `heatmap`, `liquid_metal`, `gem_smoke`
+- **`pinepaper_image_filter` corregido y ampliado** — conectado al motor real de filtros GPU con los 15 filtros (familia de semitonos, posterizar, viñeta, HSL, dither…)
+- **El README como recurso MCP** — los clientes pueden leer `pinepaper://docs/readme` (con variantes por idioma) sin salir del protocolo
+
+## Más
+
+La referencia completa de herramientas, los toolkits y el presupuesto de tokens, y la lista de relaciones están en el [README en inglés](README.md). El flujo de trabajo canónico para agentes está en el recurso `pinepaper://docs/agent-guide`.
+
+Licencia MIT · [pinepaper.studio](https://pinepaper.studio)

package/README.fr.md

@@ -0,0 +1,71 @@
+# Serveur MCP PinePaper
+
+> Créez des graphiques vectoriels animés avec l'IA via le Model Context Protocol
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · **Français** · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — graphiques animés créés par appels d'outils" width="840">
+</p>
+
+*La bannière ci-dessus est un SVG animé, exporté directement depuis des appels d'outils PinePaper — pas de vidéo, pas de GIF. Ouvrez cette page sur GitHub et regardez-la bouger.*
+
+## Aperçu
+
+Le serveur MCP PinePaper permet aux assistants IA de créer et d'animer des graphiques dans [PinePaper Studio](https://pinepaper.studio) via le Model Context Protocol. Compatible avec toute IA gérant les appels d'outils MCP (Claude, GPT, Gemini, modèles locaux, etc.).
+
+Il expose **121 outils** : dessin, animation, diagrammes, cartes, typographie, physique, retouche d'image, visualisation de données et export :
+
+- Créer du texte, des formes, de la géométrie et des graphiques complexes
+- Animer avec des **relations** déclaratives plutôt que des images clés
+- Fonds procéduraux et trajectoires par équations
+- Diagrammes, cartes, graphiques et collages de lettres
+- Retouche d'image : recadrage, incrustation chroma (fond vert), filtres GPU, découpe au lasso, détection d'objets
+- Export SVG animé, images vidéo, widgets embarquables et données d'entraînement LLM
+
+## Démarrage rapide
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop** (`claude_desktop_config.json`) :
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+Essayez de demander à votre IA :
+
+> « Crée un texte HELLO rouge avec une animation de pulsation »
+
+> « Crée un soleil et une terre, et fais orbiter la terre autour du soleil »
+
+> « Ajoute un fond de rayons de soleil bleu et violet »
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="Affiche au soleil tournant">
+  <img src="assets/easing-splashes.svg" width="300" alt="Formes rebondissant en cascade">
+  <img src="assets/live-badge.svg" width="180" alt="Badge LIVE clignotant">
+</p>
+
+## Nouveautés de la 1.6.0
+
+- **Outils de retouche d'image** : `pinepaper_crop_image` (recadrage en une étape, conserve l'id et les relations) et `pinepaper_chroma_key` (chroma avec seuil auto-estimé)
+- **`pinepaper_media` gagne `set_clip`** — re-découpe un clip déjà téléversé
+- **Auras shader** dans `pinepaper_apply_effect` : `heatmap`, `liquid_metal`, `gem_smoke`
+- **`pinepaper_image_filter` corrigé et enrichi** — branché sur le vrai moteur de filtres GPU avec les 15 filtres (famille demi-teinte, postérisation, vignettage, HSL, tramage…)
+- **Le README devient une ressource MCP** — les clients peuvent lire `pinepaper://docs/readme` (avec variantes par langue) sans quitter le protocole
+
+## Aller plus loin
+
+La référence complète des outils, les toolkits et le budget de jetons, et la liste des relations sont dans le [README anglais](README.md). Le flux de travail canonique pour agents est dans la ressource `pinepaper://docs/agent-guide`.
+
+Licence MIT · [pinepaper.studio](https://pinepaper.studio)

package/README.hi.md

@@ -0,0 +1,71 @@
+# PinePaper MCP सर्वर
+
+> Model Context Protocol के ज़रिए AI से एनिमेटेड वेक्टर ग्राफ़िक्स बनाएँ
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · **हिन्दी**
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — टूल कॉल से बने एनिमेटेड ग्राफ़िक्स" width="840">
+</p>
+
+*ऊपर का बैनर एक एनिमेटेड SVG है — PinePaper टूल कॉल से सीधे एक्सपोर्ट किया गया, न कोई वीडियो, न GIF। GitHub पर खोलें और इसे चलते देखें।*
+
+## परिचय
+
+PinePaper MCP सर्वर AI असिस्टेंट्स को Model Context Protocol के ज़रिए [PinePaper Studio](https://pinepaper.studio) में ग्राफ़िक्स बनाने और एनिमेट करने देता है। MCP टूल कॉलिंग वाले किसी भी AI (Claude, GPT, Gemini, लोकल मॉडल आदि) के साथ काम करता है।
+
+सर्वर **121 टूल** देता है — ड्रॉइंग, एनिमेशन, डायग्राम, नक्शे, टाइपोग्राफ़ी, फिज़िक्स, इमेज एडिटिंग, डेटा विज़ुअलाइज़ेशन और एक्सपोर्ट:
+
+- टेक्स्ट, आकृतियाँ, ज्यामिति और जटिल ग्राफ़िक्स बनाना
+- कीफ़्रेम की जगह व्यवहार बताने वाले **रिलेशन** से एनिमेशन
+- प्रोसीजरल बैकग्राउंड और समीकरण-आधारित पथ
+- डायग्राम, नक्शे, चार्ट और लेटर कोलाज
+- इमेज एडिटिंग: क्रॉप, क्रोमा-की (ग्रीन स्क्रीन हटाना), GPU फ़िल्टर, लैसो कटआउट, ऑब्जेक्ट डिटेक्शन
+- एनिमेटेड SVG, वीडियो फ़्रेम, एम्बेड करने लायक विजेट और LLM ट्रेनिंग डेटा एक्सपोर्ट
+
+## जल्दी शुरू करें
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+अपने AI से कहकर देखें:
+
+> "लाल रंग का धड़कता हुआ HELLO टेक्स्ट बनाओ"
+
+> "एक सूरज और एक पृथ्वी बनाओ, और पृथ्वी को सूरज की परिक्रमा कराओ"
+
+> "नीले-बैंगनी रंग का सनबर्स्ट बैकग्राउंड जोड़ो"
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="घूमता सनबर्स्ट पोस्टर">
+  <img src="assets/easing-splashes.svg" width="300" alt="क्रम से उछलती स्प्लैश आकृतियाँ">
+  <img src="assets/live-badge.svg" width="180" alt="झपकता LIVE बैज">
+</p>
+
+## 1.6.0 में नया क्या है
+
+- **इमेज एडिटिंग टूल**: `pinepaper_crop_image` (एक चरण में क्रॉप, id और रिलेशन बरकरार) और `pinepaper_chroma_key` (स्वतः अनुमानित थ्रेशोल्ड वाला क्रोमा-की)
+- **`pinepaper_media` में `set_clip`** — पहले से अपलोड क्लिप की ट्रिम फिर से सेट करें
+- **शेडर ऑरा**: `pinepaper_apply_effect` में `heatmap`, `liquid_metal`, `gem_smoke`
+- **`pinepaper_image_filter` ठीक और विस्तारित** — असली GPU फ़िल्टर इंजन से जुड़ा, पूरे 15 फ़िल्टर (हाफ़टोन परिवार, पोस्टराइज़, विनेट, HSL, डिदर…)
+- **README अब MCP रिसोर्स है** — क्लाइंट `pinepaper://docs/readme` (भाषा-वार वेरिएंट सहित) प्रोटोकॉल के भीतर पढ़ सकते हैं
+
+## और जानें
+
+टूल का पूरा संदर्भ, टूलकिट और टोकन बजट, तथा रिलेशन की सूची [अंग्रेज़ी README](README.md) में है। एजेंटों के लिए मानक वर्कफ़्लो `pinepaper://docs/agent-guide` रिसोर्स में है।
+
+MIT लाइसेंस · [pinepaper.studio](https://pinepaper.studio)

package/README.ja.md

@@ -0,0 +1,71 @@
+# PinePaper MCP サーバー
+
+> Model Context Protocol で AI がアニメーション付きベクターグラフィックを作る
+
+[English](README.md) · [简体中文](README.zh-CN.md) · **日本語** · [한국어](README.ko.md) · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — ツールコールから生まれるアニメーション" width="840">
+</p>
+
+*上のバナーはアニメーション SVG です。PinePaper のツールコールからそのまま書き出したもので、動画ファイルも GIF もありません。GitHub 上で開けば動いて見えます。*
+
+## 概要
+
+PinePaper MCP サーバーは、MCP 経由で AI アシスタントが [PinePaper Studio](https://pinepaper.studio) 上にグラフィックを作成・アニメーションさせるためのサーバーです。MCP ツールコールに対応した AI（Claude、GPT、Gemini、ローカルモデルなど）で動作します。
+
+**121 個のツール**を提供 — 描画・アニメーション・図・地図・タイポグラフィ・物理・画像編集・データ可視化・エクスポート：
+
+- テキスト、図形、ジオメトリ、複雑なグラフィックの作成
+- キーフレームではなく、ふるまいを宣言する**リレーション**でアニメーション
+- プロシージャル背景・数式パス
+- ダイアグラム、地図、チャート、レターコラージュ
+- 画像編集：クロップ、クロマキー背景除去、GPU フィルター、なげなわ切り抜き、物体検出
+- アニメーション SVG、動画フレーム、埋め込みウィジェット、LLM 学習データの書き出し
+
+## クイックスタート
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop**（`claude_desktop_config.json`）：
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+AI にこう頼んでみてください：
+
+> 「赤くパルスする HELLO のテキストを作って」
+
+> 「太陽と地球を作って、地球を太陽の周りに公転させて」
+
+> 「青と紫のサンバースト背景を追加して」
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="回転するサンバーストのポスター">
+  <img src="assets/easing-splashes.svg" width="300" alt="時間差でバウンドするスプラッシュ">
+  <img src="assets/live-badge.svg" width="180" alt="点滅する LIVE バッジ">
+</p>
+
+## 1.6.0 の新機能
+
+- **画像編集ツール**：`pinepaper_crop_image`（ワンショットクロップ、id とリレーションを維持）、`pinepaper_chroma_key`（しきい値自動推定のクロマキー）
+- **`pinepaper_media` に `set_clip`** — アップロード済みクリップのトリムをやり直し
+- **シェーダーオーラ**：`pinepaper_apply_effect` に `heatmap` / `liquid_metal` / `gem_smoke`
+- **`pinepaper_image_filter` を修正・拡充** — 実際の GPU フィルターエンジンに接続、全 15 フィルター（ハーフトーン、ポスタリゼーション、ビネット、HSL、ディザなど）
+- **README が MCP リソースに** — クライアントは `pinepaper://docs/readme`（言語別あり）をプロトコル内で読めます
+
+## さらに詳しく
+
+ツールの完全なリファレンス、ツールキットとトークン予算、リレーション一覧は[英語版 README](README.md) を参照してください。AI エージェント向けの正準ワークフローはリソース `pinepaper://docs/agent-guide` にあります。
+
+MIT ライセンス · [pinepaper.studio](https://pinepaper.studio)

package/README.ko.md

@@ -0,0 +1,71 @@
+# PinePaper MCP 서버
+
+> Model Context Protocol로 AI가 애니메이션 벡터 그래픽을 만든다
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · **한국어** · [Español](README.es.md) · [Português (BR)](README.pt-BR.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [हिन्दी](README.hi.md)
+
+<p align="center">
+  <img src="assets/hero.svg" alt="PinePaper MCP — 툴 콜로 만든 애니메이션" width="840">
+</p>
+
+*위 배너는 애니메이션 SVG입니다. PinePaper 툴 콜에서 그대로 내보낸 것으로, 동영상도 GIF도 아닙니다. GitHub에서 열면 움직입니다.*
+
+## 개요
+
+PinePaper MCP 서버는 AI 어시스턴트가 MCP를 통해 [PinePaper Studio](https://pinepaper.studio)에서 그래픽을 만들고 애니메이션하게 해줍니다. MCP 툴 콜을 지원하는 모든 AI(Claude, GPT, Gemini, 로컬 모델 등)와 호환됩니다.
+
+**121개의 툴** 제공 — 드로잉, 애니메이션, 다이어그램, 지도, 타이포그래피, 물리, 이미지 편집, 데이터 시각화, 내보내기:
+
+- 텍스트·도형·기하·복잡한 그래픽 생성
+- 키프레임 대신 행동을 선언하는 **릴레이션**으로 애니메이션
+- 프로시저럴 배경과 수식 기반 경로
+- 다이어그램, 지도, 차트, 레터 콜라주
+- 이미지 편집: 크롭, 크로마키 배경 제거, GPU 필터, 올가미 오려내기, 객체 감지
+- 애니메이션 SVG, 비디오 프레임, 임베드 위젯, LLM 학습 데이터 내보내기
+
+## 빠른 시작
+
+```bash
+npm install -g @pinepaper.studio/mcp-server
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pinepaper": {
+      "command": "npx",
+      "args": ["-y", "@pinepaper.studio/mcp-server"]
+    }
+  }
+}
+```
+
+AI에게 이렇게 말해 보세요:
+
+> "빨간색으로 맥박 치는 HELLO 텍스트를 만들어 줘"
+
+> "태양과 지구를 만들고 지구가 태양을 공전하게 해 줘"
+
+> "파랑·보라 선버스트 배경을 넣어 줘"
+
+<p align="center">
+  <img src="assets/poster-sunburst.svg" width="220" alt="회전하는 선버스트 포스터">
+  <img src="assets/easing-splashes.svg" width="300" alt="시차 바운스 스플래시">
+  <img src="assets/live-badge.svg" width="180" alt="깜박이는 LIVE 배지">
+</p>
+
+## 1.6.0의 새 기능
+
+- **이미지 편집 툴**: `pinepaper_crop_image`(원샷 크롭, id·릴레이션 유지), `pinepaper_chroma_key`(임계값 자동 추정 크로마키)
+- **`pinepaper_media`에 `set_clip` 추가** — 업로드된 클립의 트림 재조정
+- **셰이더 아우라**: `pinepaper_apply_effect`에 `heatmap` / `liquid_metal` / `gem_smoke`
+- **`pinepaper_image_filter` 수정·확장** — 실제 GPU 필터 엔진에 연결, 15종 전체 필터(하프톤 계열, 포스터라이즈, 비네트, HSL, 디더 등)
+- **README가 MCP 리소스로** — 클라이언트가 `pinepaper://docs/readme`(언어별 변형 포함)를 프로토콜 안에서 읽을 수 있음
+
+## 더 보기
+
+전체 툴 레퍼런스, 툴킷과 토큰 예산, 릴레이션 목록은 [영어 README](README.md)를 참고하세요. AI 에이전트용 표준 워크플로는 리소스 `pinepaper://docs/agent-guide`에 있습니다.
+
+MIT 라이선스 · [pinepaper.studio](https://pinepaper.studio)