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
This commit is contained in:
João Henrique
Executable
+16
@@ -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.
|
||||
Executable
+70
@@ -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.
|
||||
Executable
+77
@@ -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.
|
||||
Executable
+70
@@ -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 パッケージも別途
|
||||
アンインストールしてください。
|
||||
Executable
+18
@@ -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"
|
||||
}
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user