feat: initial commit - Jhonny Editor

- Adicionado estrutura completa do projeto - Configurado MCP server para Premiere Pro - Adicionado documentação e skills - Configurado Gitignore para o projeto
2026-09-08 09:59:31 -04:00
commit b541f502ba
1507 changed files with 387650 additions and 0 deletions
@@ -0,0 +1,16 @@
+# Quick-start translations
+
+[`en.md`](en.md) is the maintained English source. The translations preserve
+the same marked sections and are machine-assisted drafts, not certified
+translations. Technical command names, product names, and JSON keys remain in
+English where that prevents a setup error.
+
+| Language | Guide | Review status |
+| --- | --- | --- |
+| English | [English](en.md) | Source |
+| Español | [Español](es.md) | Machine-assisted draft; community review welcome |
+| 日本語 | [日本語](ja.md) | Machine-assisted draft; community review welcome |
+
+When changing the source, update every marked section in each listed locale and
+run `npm run docs:quickstart:check`. The check guards structure and links; a
+native speaker still reviews wording before a translation becomes authoritative.
@@ -0,0 +1,70 @@
+# Premiere MCP quick start
+
+This is the maintained English source for the translated quick-start guides.
+Use it with the repository [README](../../README.md), which has the current
+download links and supported-version details.
+
+<!-- quickstart:section=before-you-start -->
+## Before you start
+
+Use a copy of a test project, not active client work. The local MCP server, the
+Premiere connector, and your AI client must run on the same computer. Start
+with a read-only connection check; installation and a green panel status do not
+prove an editing workflow has succeeded in a licensed host.
+
+<!-- quickstart:section=install -->
+## Install the server and connector
+
+For Claude Desktop, install the current `.mcpb` bundle and the separate signed
+Premiere connector from the current GitHub release. Restart both apps.
+
+For another MCP client, install the server and then the CEP connector:
+
+```bash
+npm install -g premiere-pro-mcp
+premiere-pro-mcp --install-cep
+```
+
+Configure the client to run `premiere-pro-mcp`. The full README includes
+client-specific JSON examples.
+
+<!-- quickstart:section=prove-connection -->
+## Prove the connection safely
+
+1. Open Premiere, open the copied test project, and open an active sequence.
+2. In Premiere, choose **Window > Extensions > MCP for Adobe Premiere Pro**.
+   “Running” means the panel bridge is available; it is not a completed-edit
+   claim.
+3. Run the local preflight:
+
+   ```bash
+   premiere-pro-mcp --doctor
+   ```
+
+4. Ask the AI client: `Run verify_premiere_connection. Make no changes.`
+
+The local doctor reports package/configuration discovery. The MCP response
+reports the selected bridge, project, and sequence readiness without returning
+project details. Treat a failure or missing sequence as a setup result to fix,
+not as permission to retry a mutation.
+
+<!-- quickstart:section=first-edit -->
+## Make the first edit deliberately
+
+After the read-only check succeeds, ask for a bounded plan against the copied
+test sequence. Review the target, changes, and confirmation boundary before
+allowing an edit. Re-inspect the sequence afterwards and use Undo to verify the
+fixture returns to its previous state.
+
+<!-- quickstart:section=remove -->
+## Remove the connector
+
+Fully quit Premiere first, then remove only this CEP connector:
+
+```bash
+premiere-pro-mcp --uninstall-cep
+```
+
+This leaves Adobe's shared debug setting unchanged so other CEP extensions are
+not disrupted. Remove the MCP server from the AI client's configuration and
+uninstall the npm package separately if you no longer use it.
@@ -0,0 +1,77 @@
+# Inicio rápido de Premiere MCP
+
+Esta es una traducción asistida por máquina del origen en
+[inglés](en.md); agradecemos la revisión de la comunidad. Úsela junto con el
+[README](../../README.md), que contiene los enlaces de descarga y versiones
+compatibles actuales.
+
+<!-- quickstart:section=before-you-start -->
+## Antes de empezar
+
+Use una copia de un proyecto de prueba, nunca trabajo activo de un cliente. El
+servidor MCP local, el conector de Premiere y el cliente de IA deben ejecutarse
+en el mismo equipo. Empiece con una comprobación de conexión de solo lectura:
+la instalación y el estado verde del panel no demuestran que una edición haya
+funcionado en un host de Premiere con licencia.
+
+<!-- quickstart:section=install -->
+## Instale el servidor y el conector
+
+Para Claude Desktop, instale el paquete `.mcpb` actual y el conector firmado
+separado de Premiere desde la versión actual de GitHub. Reinicie ambas
+aplicaciones.
+
+Para otro cliente MCP, instale el servidor y después el conector CEP:
+
+```bash
+npm install -g premiere-pro-mcp
+premiere-pro-mcp --install-cep
+```
+
+Configure el cliente para ejecutar `premiere-pro-mcp`. El README completo
+incluye ejemplos JSON específicos por cliente.
+
+<!-- quickstart:section=prove-connection -->
+## Compruebe la conexión sin riesgos
+
+1. Abra Premiere, abra el proyecto de prueba copiado y abra una secuencia
+   activa.
+2. En Premiere, elija **Window > Extensions > MCP for Adobe Premiere Pro**.
+   “Running” significa que el puente del panel está disponible; no demuestra
+   que se haya completado una edición.
+3. Ejecute la comprobación local:
+
+   ```bash
+   premiere-pro-mcp --doctor
+   ```
+
+4. Pida al cliente de IA: `Run verify_premiere_connection. Make no changes.`
+
+El doctor local informa del descubrimiento del paquete y de la configuración.
+La respuesta MCP informa del puente seleccionado y de la disponibilidad del
+proyecto y la secuencia sin devolver detalles del proyecto. Considere un fallo
+o una secuencia ausente como un resultado de configuración que debe corregirse,
+no como permiso para repetir una mutación.
+
+<!-- quickstart:section=first-edit -->
+## Realice la primera edición con cuidado
+
+Tras superar la comprobación de solo lectura, pida un plan limitado para la
+secuencia de prueba copiada. Revise el destino, los cambios y el límite de
+confirmación antes de permitir una edición. Después vuelva a inspeccionar la
+secuencia y use Deshacer para comprobar que el fixture vuelve a su estado
+anterior.
+
+<!-- quickstart:section=remove -->
+## Elimine el conector
+
+Cierre Premiere por completo y después elimine solamente este conector CEP:
+
+```bash
+premiere-pro-mcp --uninstall-cep
+```
+
+Esto deja sin cambios la configuración compartida de depuración de Adobe para
+no interrumpir otras extensiones CEP. Elimine también el servidor MCP de la
+configuración del cliente de IA y desinstale el paquete npm por separado si ya
+no lo utiliza.
@@ -0,0 +1,70 @@
+# Premiere MCP クイックスタート
+
+これは[英語版](en.md)を元にした機械支援翻訳のドラフトです。コミュニティによる
+レビューを歓迎します。現在のダウンロードリンクと対応バージョンについては
+[README](../../README.md) も参照してください。
+
+<!-- quickstart:section=before-you-start -->
+## 始める前に
+
+実案件ではなく、テスト用プロジェクトのコピーを使用してください。ローカル MCP
+サーバー、Premiere コネクター、AI クライアントは同じコンピューターで動作している
+必要があります。まず読み取り専用の接続確認を行います。インストール済みであること
+やパネルが緑色であることは、ライセンス済み Premiere ホストで編集が成功した証明には
+なりません。
+
+<!-- quickstart:section=install -->
+## サーバーとコネクターをインストールする
+
+Claude Desktop では、現在の GitHub リリースから `.mcpb` バンドルと、別配布の署名済み
+Premiere コネクターをインストールしてください。両方のアプリを再起動します。
+
+他の MCP クライアントでは、サーバーの後に CEP コネクターをインストールします。
+
+```bash
+npm install -g premiere-pro-mcp
+premiere-pro-mcp --install-cep
+```
+
+クライアントには `premiere-pro-mcp` を実行するよう設定します。クライアント別の JSON
+例は完全版 README にあります。
+
+<!-- quickstart:section=prove-connection -->
+## 安全に接続を確認する
+
+1. Premiere を開き、コピーしたテストプロジェクトとアクティブなシーケンスを開きます。
+2. Premiere で **Window > Extensions > MCP for Adobe Premiere Pro** を選びます。
+   “Running” はパネルブリッジが利用可能であることを示すだけで、編集完了の主張では
+   ありません。
+3. ローカルの事前確認を実行します。
+
+   ```bash
+   premiere-pro-mcp --doctor
+   ```
+
+4. AI クライアントに次のよう依頼します: `Run verify_premiere_connection. Make no changes.`
+
+ローカル doctor はパッケージと設定の検出結果を報告します。MCP の応答は、プロジェクト
+詳細を返さずに、選択したブリッジ、プロジェクト、シーケンスの準備状態を報告します。
+失敗やシーケンス未選択は設定を修正すべき結果であり、変更操作を再試行する許可では
+ありません。
+
+<!-- quickstart:section=first-edit -->
+## 最初の編集は慎重に行う
+
+読み取り専用チェックが成功した後、コピーしたテストシーケンスを対象とする限定的な
+計画を依頼します。編集を許可する前に、対象、変更内容、確認境界を確認してください。
+その後シーケンスを再確認し、Undo でフィクスチャが元の状態に戻ることを確認します。
+
+<!-- quickstart:section=remove -->
+## コネクターを削除する
+
+最初に Premiere を完全に終了してから、この CEP コネクターだけを削除します。
+
+```bash
+premiere-pro-mcp --uninstall-cep
+```
+
+他の CEP 拡張機能を妨げないよう、Adobe の共有デバッグ設定は変更しません。不要になった
+場合は、AI クライアントの設定から MCP サーバーを削除し、npm パッケージも別途
+アンインストールしてください。
@@ -0,0 +1,18 @@
+{
+  "schemaVersion": "premiere-pro-mcp.quickstart-locales.v1",
+  "source": "en.md",
+  "locales": [
+    {
+      "code": "es",
+      "file": "es.md",
+      "language": "Español",
+      "reviewStatus": "machine-assisted draft; community review welcome"
+    },
+    {
+      "code": "ja",
+      "file": "ja.md",
+      "language": "日本語",
+      "reviewStatus": "machine-assisted draft; community review welcome"
+    }
+  ]
+}