backdraw 2.1.0 → 2.1.1

package/README.md

@@ -6,6 +6,10 @@
   <b>Let Claude generate images with your own ChatGPT account, in a background Chrome tab.<br>No API key, no extra cost, nothing to watch.</b>
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/backdraw"><img src="https://img.shields.io/npm/v/backdraw" alt="npm version"></a>
+</p>
+
 <p align="center">
   <img src="branding/demo/backdraw-demo.gif" alt="Right-click images on the web to save them as references, then Claude Code asks Backdraw for an image in that style; ChatGPT draws it in a background tab and the file is saved on the PC" width="100%">
 </p>
@@ -123,6 +127,8 @@ Run this in PowerShell or cmd (no admin rights needed):
 npx backdraw@latest setup
 ```
 
+It runs the [`backdraw` package from npm](https://www.npmjs.com/package/backdraw).
+
 `setup` does everything except one click in the browser:
 
 1. It copies Backdraw to `%USERPROFILE%\.backdraw` (npx's own copy is temporary) and sets up the
@@ -145,6 +151,28 @@ npx backdraw@latest setup
 The native host is still named `io.github.muhammedtalha04.backdraw`, after the project's old GitHub
 user name: renaming it would break existing installs.
 
+### Install from your client
+
+Your MCP client can also add Backdraw itself; it then starts the server with
+`npx backdraw@latest mcp`. The browser side still needs a one-time setup on the PC, which leaves the
+clients alone:
+
+```
+npx backdraw@latest setup --clients=none
+```
+
+| Client | Add Backdraw |
+|---|---|
+| Claude Code | `/plugin install backdraw --marketplace devtalh/backdraw` (Claude Code 2.1.275 or later; or `/plugin marketplace add devtalh/backdraw`, then `/plugin install backdraw@backdraw`). `/backdraw:setup` explains the browser step. |
+| Cursor | [![Add Backdraw to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=backdraw&config=eyJjb21tYW5kIjoiY21kIiwiYXJncyI6WyIvYyIsIm5weCIsIi15IiwiYmFja2RyYXdAbGF0ZXN0IiwibWNwIl19) |
+| VS Code | [![Install Backdraw in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=backdraw&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22cmd%22%2C%22args%22%3A%5B%22%2Fc%22%2C%22npx%22%2C%22-y%22%2C%22backdraw%40latest%22%2C%22mcp%22%5D%7D) |
+| Codex | `codex mcp add backdraw -- cmd /c npx -y backdraw@latest mcp` |
+| Gemini CLI | `npx backdraw@latest setup --clients=gemini` |
+
+On Windows the command goes through `cmd /c`, because clients start `npx` without a shell. Use one
+way per client: if setup already added Backdraw to Claude Code, the plugin would start a second
+server with the same tools.
+
 ### Manual install
 
 1. **Get the code.** Clone the repository with git, or download it as a ZIP (**Code** →
@@ -435,7 +463,8 @@ waiting; the job keeps running until `cancel_job` stops it.
 
 For setup and troubleshooting, run these in the Backdraw folder (`%USERPROFILE%\.backdraw`, or the
 folder you installed from). From anywhere, `npx backdraw <command>` runs the same commands, e.g.
-`npx backdraw status`. `npm run status` is the same as `node cli.js status`.
+`npx backdraw status`. `npm run status` is the same as `node cli.js status`. `backdraw mcp` runs
+the MCP server itself on stdio; that is what MCP clients start.
 
 ```
 node cli.js status                          Bridge status (Chrome connected, selected project, queue)

package/README.tr.md

@@ -6,6 +6,10 @@
   <b>Claude, kendi ChatGPT hesabınla, Chrome'da arka plandaki bir sekmede görsel üretsin.<br>API anahtarı yok, ek ücret yok, başında beklemene gerek yok.</b>
 </p>
 
+<p align="center">
+  <a href="https://www.npmjs.com/package/backdraw"><img src="https://img.shields.io/npm/v/backdraw" alt="npm sürümü"></a>
+</p>
+
 <p align="center">
   <img src="branding/demo/backdraw-demo.gif" alt="Web'deki görseller sağ tıkla referans olarak kaydediliyor, sonra Claude Code Backdraw'dan o tarzda bir görsel istiyor; ChatGPT görseli arka plan sekmesinde çiziyor ve dosya bilgisayara kaydediliyor" width="100%">
 </p>
@@ -123,6 +127,8 @@ Bunu PowerShell'de ya da cmd'de çalıştır (yönetici izni gerekmez):
 npx backdraw@latest setup
 ```
 
+Bu komut [npm'deki `backdraw` paketini](https://www.npmjs.com/package/backdraw) çalıştırır.
+
 `setup`, tarayıcıdaki tek bir tıklama dışında her şeyi yapar:
 
 1. Backdraw'ı `%USERPROFILE%\.backdraw` klasörüne kopyalar (npx'in kendi kopyası geçicidir) ve görsel
@@ -146,6 +152,28 @@ npx backdraw@latest setup
 Native host'un adı, projenin eski GitHub kullanıcı adından gelen
 `io.github.muhammedtalha04.backdraw` olarak kalıyor: adı değiştirmek mevcut kurulumları bozardı.
 
+### İstemcinden kur
+
+MCP istemcin Backdraw'ı kendisi de ekleyebilir; o zaman sunucuyu `npx backdraw@latest mcp` ile
+başlatır. Tarayıcı tarafı yine de bilgisayarda bir kerelik bir kurulum ister; bu kurulum istemcilere
+dokunmaz:
+
+```
+npx backdraw@latest setup --clients=none
+```
+
+| İstemci | Backdraw'ı ekle |
+|---|---|
+| Claude Code | `/plugin install backdraw --marketplace devtalh/backdraw` (Claude Code 2.1.275 ya da daha yeni; ya da önce `/plugin marketplace add devtalh/backdraw`, sonra `/plugin install backdraw@backdraw`). `/backdraw:setup` tarayıcı adımını anlatır. |
+| Cursor | [![Backdraw'ı Cursor'a ekle](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=backdraw&config=eyJjb21tYW5kIjoiY21kIiwiYXJncyI6WyIvYyIsIm5weCIsIi15IiwiYmFja2RyYXdAbGF0ZXN0IiwibWNwIl19) |
+| VS Code | [![Backdraw'ı VS Code'a kur](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=backdraw&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22cmd%22%2C%22args%22%3A%5B%22%2Fc%22%2C%22npx%22%2C%22-y%22%2C%22backdraw%40latest%22%2C%22mcp%22%5D%7D) |
+| Codex | `codex mcp add backdraw -- cmd /c npx -y backdraw@latest mcp` |
+| Gemini CLI | `npx backdraw@latest setup --clients=gemini` |
+
+Windows'ta komut `cmd /c` üzerinden çalışır, çünkü istemciler `npx`'i kabuk olmadan başlatır. Her
+istemci için tek yol kullan: setup Backdraw'ı Claude Code'a zaten eklediyse, plugin aynı araçlarla
+ikinci bir sunucu başlatır.
+
 ### Elle kurulum
 
 1. **Kodu indir.** Depoyu git ile klonla ya da ZIP olarak indir (**Code** → **Download ZIP**) ve
@@ -446,7 +474,8 @@ beklemeyi durdurur; iş, `cancel_job` onu durdurana kadar sürer.
 
 Kurulum ve sorun giderme için bunları Backdraw klasöründe çalıştır (`%USERPROFILE%\.backdraw` ya da
 kurulumu yaptığın klasör). Her yerden `npx backdraw <komut>` aynı komutları çalıştırır, örneğin
-`npx backdraw status`. `npm run status`, `node cli.js status` ile aynıdır.
+`npx backdraw status`. `npm run status`, `node cli.js status` ile aynıdır. `backdraw mcp`, MCP
+sunucusunun kendisini stdio üzerinde çalıştırır; MCP istemcilerinin başlattığı budur.
 
 ```
 node cli.js status                          Köprünün durumu (Chrome bağlı mı, seçili proje, kuyruk)

package/bin/backdraw.js

@@ -16,6 +16,7 @@ Usage: backdraw <command>
                                   clients: claude-code, claude-desktop, codex, cursor, vscode, gemini
   doctor [--fix]                  Check the install; --fix repairs registrations
   uninstall [--dry-run]           Remove the registrations (your images and settings stay)
+  mcp                             Run the MCP server on stdio (what MCP clients start; needs setup once)
   --version                       Print the version
 ${cli.USAGE.split('\n').slice(1).join('\n')}`;
 
@@ -33,6 +34,9 @@ async function main(argv) {
   const [cmd, ...rest] = argv;
   const { flags } = parseArgs(rest, { booleans: ['yes', 'fix', 'dry-run', 'no-wait'] });
   switch (cmd) {
+    // stdout belongs to the JSON-RPC stream from here on; the server reads stdin until it closes.
+    case 'mcp':
+      return require('../mcp-server');
     case '-v': case '--version': case 'version':
       return console.log(VERSION);
     case 'setup':

package/extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Backdraw",
   "short_name": "Backdraw",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "__MSG_extDescription__",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtu/jyAJ3e3hnNrNGCxfzvHLOp80L9c3j71jmQV2ymY1DbPfZNJUdrszM3dnk6SFlm/X42F/e1Pf9RoQqMKujWr7KRTtH257vBMmLbk8Eo0LytpGP0F8WOQIcp5TxLZgvqSlGTjdbB2QFJt+uisJFE8Y3nWnZpsmejes0m9NObpqBc7Q1tzZrDAnh6gzddyF8fkYU/gS2Qtu5Vd2YbRiVN18tUUh2Bb+QuXlTlzOE1JQ49A9qRTmXejtcn943ZaQ0aucooNQU4hZAFVUT+25UhzuGMZDFzZALqL19hP0EP4Erm1yitjICvR5yK/7nYObGa3LynEeH7dDJ+qoJaf4TEQIDAQAB",
   "default_locale": "en",

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "backdraw",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Local MCP server, native messaging host and Chrome extension that let Claude generate images with your own signed-in ChatGPT account in a background tab.",
+  "mcpName": "io.github.devtalh/backdraw",
   "license": "MIT",
   "author": "devtalh",
   "homepage": "https://github.com/devtalh/backdraw#readme",
@@ -49,8 +50,5 @@
     "status": "node cli.js status",
     "install-bridge": "node install.js",
     "test": "node --test"
-  },
-  "os": [
-    "win32"
-  ]
+  }
 }

package/setup.js

@@ -3,7 +3,7 @@
 // own copy is temporary), registers the native host for the installed browsers, adds Backdraw to
 // the MCP clients the user picks, then walks through loading the extension and waits for it.
 //   --yes                 no questions: every client that was found
-//   --clients=a,b         exactly these (ids: see CLIENT_IDS)
+//   --clients=a,b         exactly these (ids: see CLIENT_IDS); --clients=none: none, the browser side only
 //   --browser=edge        the browser to load the extension in (default: the first one found)
 //   --no-wait             don't wait for the extension to connect
 const fs = require('fs');
@@ -31,6 +31,7 @@ function detectClients(c) {
 function parseClientList(value) {
   if (value === true || value === '') throw new Error(`--clients needs a list, e.g. --clients=claude-code,cursor (one of: ${CLIENT_IDS.join(', ')}).`);
   const ids = String(value).split(',').map(s => s.trim().toLowerCase()).filter(Boolean);
+  if (ids.length === 1 && ids[0] === 'none') return []; // the browser side only (e.g. the Claude Code plugin)
   const unknown = ids.filter(id => !CLIENT_IDS.includes(id));
   if (unknown.length) throw new Error(`Unknown client ${unknown.join(', ')}; use: ${CLIENT_IDS.join(', ')}.`);
   return [...new Set(ids)];