@atezer/figma-mcp-bridge 1.7.22 → 1.7.24

package/CHANGELOG.md

@@ -12,6 +12,36 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) biçimine uygu
 
 Bu changelog'a ekleme öncesi sürümlerin tam ayrıntıları için `git log` kullanılabilir.
 
+## [1.7.23] - 2026-04-11
+
+### Refactor: Local Full + Cloudflare Modları Kaldırıldı
+
+Proje artık yalnızca **plugin-only** modunu destekliyor. CDP debug port (9222), Figma REST API ve Cloudflare Workers modları kaldırıldı. ~15.000+ satır kod temizlendi.
+
+**Kaldırılan:**
+- `src/local.ts` — Full local server (CDP + REST + Puppeteer)
+- `src/index.ts` — Cloudflare Workers entry point
+- `src/browser/` — Tüm browser modülleri (Puppeteer, Cloudflare Browser Rendering)
+- `src/cloud-*.ts` — Cloudflare cloud-specific modüller
+- `src/core/figma-tools.ts` — REST API araç kaydı (3,564 satır)
+- `src/core/figma-desktop-connector.ts` — CDP connector (1,391 satır)
+- `src/core/figma-api.ts`, `console-monitor.ts`, `snippet-injector.ts`, `design-system-manifest.ts`, `figma-reconstruction-spec.ts`
+- `src/core/enrichment/` — Tüm enrichment modülleri
+- `tsconfig.cloudflare.json`, `wrangler.jsonc`, `worker-configuration.d.ts`
+- Bağımlılıklar: `@cloudflare/puppeteer`, `agents`, `puppeteer-core`, `wrangler`
+
+**Güncellenen:**
+- `package.json` — main/types → local-plugin-only, bin sadeleştirildi, 3 runtime + 1 dev bağımlılık kaldırıldı
+- `tsconfig.local.json` — Sadece plugin-only + core
+- `scripts/validate-fmcp-skills-tools.mjs` — Kaynak: sadece local-plugin-only.ts
+- `.github/workflows/ci.yml` — local.ts version check kaldırıldı
+- `KURULUM.md`, `CONTRIBUTING.md`, `f-mcp-plugin/README.md`, `f-mcp-plugin/manifest.json`
+- `.cursor/skills/f-mcp/TOOL_MAPPING.md` — 19 kaldırılan araç temizlendi
+- `src/core/types/index.ts` — Kullanılmayan tipler kaldırıldı
+- `src/core/config.ts` — Browser/console/screenshot config kaldırıldı
+
+**Korunan:** 46 MCP aracı, 19 skill, plugin bridge (WebSocket 5454), audit log
+
 ## [1.7.19] - 2026-04-10
 
 ### Fix: `figma_create_frame` Otomatik Pozisyonlama

package/README.md

@@ -138,7 +138,7 @@ Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 
 | | |
 |---|---|
-| Güncel sürüm | **1.7.14** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases)) |
+| Güncel sürüm | **1.7.23** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases)) |
 | npm | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
 | Lisans | MIT — kişisel ve ticari kullanıma açık |
 

package/dist/core/config.d.ts

@@ -7,11 +7,7 @@ import type { ServerConfig } from './types/index.js';
  */
 export declare function loadConfig(): ServerConfig;
 /**
- * Validate configuration
- */
-export declare function validateConfig(config: ServerConfig): void;
-/**
- * Get configuration with validation
+ * Get configuration
  */
 export declare function getConfig(): ServerConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuErD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA+BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2BrD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAyBzC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAExC"}

package/dist/core/config.js

@@ -4,53 +4,12 @@
 import { readFileSync, existsSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
-/**
- * Auto-detect server mode based on environment
- */
-function detectMode() {
-    // If running in Workers environment, return cloudflare
-    if (typeof globalThis !== 'undefined' && 'caches' in globalThis) {
-        return 'cloudflare';
-    }
-    // Explicit env var override
-    const modeEnv = process.env.FIGMA_MCP_MODE?.toLowerCase();
-    if (modeEnv === 'local' || modeEnv === 'cloudflare') {
-        return modeEnv;
-    }
-    // Default to local for Node.js environments
-    return 'local';
-}
 /**
  * Default configuration values
  */
 const DEFAULT_CONFIG = {
-    mode: detectMode(),
-    browser: {
-        headless: false,
-        args: [
-            '--disable-blink-features=AutomationControlled',
-            '--disable-dev-shm-usage',
-            '--no-sandbox', // Note: Only use in trusted environments
-        ],
-    },
-    console: {
-        bufferSize: 1000,
-        filterLevels: ['log', 'info', 'warn', 'error', 'debug'],
-        truncation: {
-            maxStringLength: 500,
-            maxArrayLength: 10,
-            maxObjectDepth: 3,
-            removeDuplicates: true,
-        },
-    },
-    screenshots: {
-        defaultFormat: 'png',
-        quality: 90,
-        storePath: join(process.env.TMPDIR || '/tmp', 'figma-mcp-bridge', 'screenshots'),
-    },
+    mode: 'local',
     local: {
-        debugHost: process.env.FIGMA_DEBUG_HOST || 'localhost',
-        debugPort: parseInt(process.env.FIGMA_DEBUG_PORT || '9222', 10),
         pluginBridgePort: parseInt(process.env.FIGMA_MCP_BRIDGE_PORT || process.env.FIGMA_PLUGIN_BRIDGE_PORT || '5454', 10),
         auditLogPath: process.env.FIGMA_MCP_AUDIT_LOG_PATH || undefined,
     },
@@ -78,9 +37,14 @@ export function loadConfig() {
             try {
                 const fileContent = readFileSync(configPath, 'utf-8');
                 const userConfig = JSON.parse(fileContent);
-                // Deep merge with defaults
-                const config = mergeConfig(DEFAULT_CONFIG, userConfig);
-                return config;
+                // Merge with defaults
+                return {
+                    mode: 'local',
+                    local: {
+                        ...DEFAULT_CONFIG.local,
+                        ...(userConfig.local || {}),
+                    },
+                };
             }
             catch (error) {
                 console.error(`Failed to load config from ${configPath}:`, error);
@@ -92,73 +56,9 @@ export function loadConfig() {
     return DEFAULT_CONFIG;
 }
 /**
- * Deep merge two configuration objects
- */
-function mergeConfig(defaults, overrides) {
-    return {
-        mode: overrides.mode || defaults.mode,
-        browser: {
-            ...defaults.browser,
-            ...(overrides.browser || {}),
-        },
-        console: {
-            ...defaults.console,
-            ...(overrides.console || {}),
-            truncation: {
-                ...defaults.console.truncation,
-                ...(overrides.console?.truncation || {}),
-            },
-        },
-        screenshots: {
-            ...defaults.screenshots,
-            ...(overrides.screenshots || {}),
-        },
-        local: {
-            ...defaults.local,
-            ...(overrides.local || {}),
-        },
-    };
-}
-/**
- * Validate configuration
- */
-export function validateConfig(config) {
-    // Validate browser config
-    if (!Array.isArray(config.browser.args)) {
-        throw new Error('browser.args must be an array');
-    }
-    // Validate console config
-    if (config.console.bufferSize <= 0) {
-        throw new Error('console.bufferSize must be positive');
-    }
-    if (!Array.isArray(config.console.filterLevels)) {
-        throw new Error('console.filterLevels must be an array');
-    }
-    // Validate truncation config
-    const { truncation } = config.console;
-    if (truncation.maxStringLength <= 0) {
-        throw new Error('console.truncation.maxStringLength must be positive');
-    }
-    if (truncation.maxArrayLength <= 0) {
-        throw new Error('console.truncation.maxArrayLength must be positive');
-    }
-    if (truncation.maxObjectDepth <= 0) {
-        throw new Error('console.truncation.maxObjectDepth must be positive');
-    }
-    // Validate screenshot config
-    if (!['png', 'jpeg'].includes(config.screenshots.defaultFormat)) {
-        throw new Error('screenshots.defaultFormat must be "png" or "jpeg"');
-    }
-    if (config.screenshots.quality < 0 || config.screenshots.quality > 100) {
-        throw new Error('screenshots.quality must be between 0 and 100');
-    }
-}
-/**
- * Get configuration with validation
+ * Get configuration
  */
 export function getConfig() {
-    const config = loadConfig();
-    validateConfig(config);
-    return config;
+    return loadConfig();
 }
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;GAEG;AACH,SAAS,UAAU;IACjB,uDAAuD;IACvD,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,4BAA4B;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC1D,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4CAA4C;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,cAAc,GAAiB;IACnC,IAAI,EAAE,UAAU,EAAE;IAClB,OAAO,EAAE;QACP,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE;YACJ,+CAA+C;YAC/C,yBAAyB;YACzB,cAAc,EAAE,yCAAyC;SAC1D;KACF;IACD,OAAO,EAAE;QACP,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACvD,UAAU,EAAE;YACV,eAAe,EAAE,GAAG;YACpB,cAAc,EAAE,EAAE;YAClB,cAAc,EAAE,CAAC;YACjB,gBAAgB,EAAE,IAAI;SACvB;KACF;IACD,WAAW,EAAE;QACX,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,EAAE,kBAAkB,EAAE,aAAa,CAAC;KACjF;IACD,KAAK,EAAE;QACL,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,WAAW;QACtD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,EAAE,EAAE,CAAC;QAC/D,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,MAAM,EAAE,EAAE,CAAC;QACnH,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,SAAS;KAChE;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB;IAChC,uBAAuB;IACvB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,wBAAwB,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC;IAC5C,mBAAmB;IACnB,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,EAAE,wBAAwB,CAAC;CAC1C,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,+BAA+B;IAC/B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAE3C,2BAA2B;gBAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;gBAEvD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;gBAClE,+BAA+B;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAAsB,EAAE,SAAgC;IAC3E,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;QACrC,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,OAAO;YACnB,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;SAC7B;QACD,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,OAAO;YACnB,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;YAC5B,UAAU,EAAE;gBACV,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU;gBAC9B,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;aACzC;SACF;QACD,WAAW,EAAE;YACX,GAAG,QAAQ,CAAC,WAAW;YACvB,GAAG,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC;SACjC;QACD,KAAK,EAAE;YACL,GAAG,QAAQ,CAAC,KAAM;YAClB,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;SAC3B;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,0BAA0B;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,6BAA6B;IAC7B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IACtC,IAAI,UAAU,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;GAEG;AACH,MAAM,cAAc,GAAiB;IACnC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACL,gBAAgB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,MAAM,EAAE,EAAE,CAAC;QACnH,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,SAAS;KAChE;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,gCAAgC;IAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB;IAChC,uBAAuB;IACvB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,wBAAwB,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC;IAC5C,mBAAmB;IACnB,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,EAAE,wBAAwB,CAAC;CAC1C,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,+BAA+B;IAC/B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAE3C,sBAAsB;gBACtB,OAAO;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,GAAG,cAAc,CAAC,KAAM;wBACxB,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;qBAC5B;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;gBAClE,+BAA+B;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC"}

package/dist/core/instructions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Server Instructions — sent to AI clients during initialization.
+ * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP.
+ * No Node.js dependencies — safe for Cloudflare Workers.
+ */
+export declare const FMCP_INSTRUCTIONS = "F-MCP ATezer Bridge \u2014 Plugin-based Figma MCP server.\n\nWHAT IT IS:\nF-MCP connects directly to the Figma Plugin API via WebSocket bridge (ports 5454-5470).\nIt reads real-time state from open Figma files without needing a REST API token.\nAll F-MCP tool names start with \"figma_\" and belong to the \"figma-mcp-bridge\" MCP server.\n\nWHEN TO PREFER F-MCP BRIDGE (figma-mcp-bridge tools):\n- Reading live plugin state: variables, styles, components, document structure\n- Running Plugin API code (figma_execute) for custom queries or mutations\n- Capturing screenshots without a REST token (figma_capture_screenshot)\n- Creating/modifying nodes directly: frames, text, rectangles, groups\n- Variable CRUD (create, update, delete variables and collections)\n- Design token browsing and design-code parity checks\n- Multi-file targeting via fileKey or figmaUrl params\n- Batch export (SVG/PNG/JPG/PDF) via plugin exportAsync\n- When no Figma REST API token is available\n\nWHEN TO PREFER OFFICIAL FIGMA MCP:\n- Code Connect mappings and suggestions\n- Design system search across team libraries (search_design_system)\n- Creating new Figma files (create_new_file)\n- Running Plugin API code through official channel (use_figma)\n- Generating diagrams in FigJam (generate_diagram)\n- When official Figma Cloud API OAuth integration is needed\n\nCOEXISTENCE:\nBoth servers run simultaneously on different ports with different namespaces.\nF-MCP tools are prefixed \"figma_\" in the figma-mcp-bridge server.\nOfficial tools use their own names in separate MCP server namespaces.\nChoose based on the capability needed.";
+//# sourceMappingURL=instructions.d.ts.map

package/dist/core/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,ylDA8BS,CAAC"}

package/dist/core/instructions.js

@@ -0,0 +1,37 @@
+/**
+ * MCP Server Instructions — sent to AI clients during initialization.
+ * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP.
+ * No Node.js dependencies — safe for Cloudflare Workers.
+ */
+export const FMCP_INSTRUCTIONS = `F-MCP ATezer Bridge — Plugin-based Figma MCP server.
+
+WHAT IT IS:
+F-MCP connects directly to the Figma Plugin API via WebSocket bridge (ports 5454-5470).
+It reads real-time state from open Figma files without needing a REST API token.
+All F-MCP tool names start with "figma_" and belong to the "figma-mcp-bridge" MCP server.
+
+WHEN TO PREFER F-MCP BRIDGE (figma-mcp-bridge tools):
+- Reading live plugin state: variables, styles, components, document structure
+- Running Plugin API code (figma_execute) for custom queries or mutations
+- Capturing screenshots without a REST token (figma_capture_screenshot)
+- Creating/modifying nodes directly: frames, text, rectangles, groups
+- Variable CRUD (create, update, delete variables and collections)
+- Design token browsing and design-code parity checks
+- Multi-file targeting via fileKey or figmaUrl params
+- Batch export (SVG/PNG/JPG/PDF) via plugin exportAsync
+- When no Figma REST API token is available
+
+WHEN TO PREFER OFFICIAL FIGMA MCP:
+- Code Connect mappings and suggestions
+- Design system search across team libraries (search_design_system)
+- Creating new Figma files (create_new_file)
+- Running Plugin API code through official channel (use_figma)
+- Generating diagrams in FigJam (generate_diagram)
+- When official Figma Cloud API OAuth integration is needed
+
+COEXISTENCE:
+Both servers run simultaneously on different ports with different namespaces.
+F-MCP tools are prefixed "figma_" in the figma-mcp-bridge server.
+Official tools use their own names in separate MCP server namespaces.
+Choose based on the capability needed.`;
+//# sourceMappingURL=instructions.js.map

package/dist/core/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA8BM,CAAC"}

package/dist/core/plugin-bridge-server.js

@@ -326,7 +326,7 @@ export class PluginBridgeServer {
                             logger.info({ clientId, fileKey: incomingFileKey, fileName: incomingFileName }, "Plugin bridge: client registered (fileKey=%s, fileName=%s)", incomingFileKey, incomingFileName);
                             ws.send(JSON.stringify({
                                 type: "welcome",
-                                bridgeVersion: "1.7.19",
+                                bridgeVersion: "1.7.24",
                                 port: this.port,
                                 clientId,
                                 multiClient: true,

package/dist/core/types/index.d.ts

@@ -1,116 +1,20 @@
 /**
  * Type definitions for F-MCP ATezer (Figma MCP Bridge)
  */
-/**
- * Console log entry captured from Figma plugin
- */
-export interface ConsoleLogEntry {
-    timestamp: number;
-    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
-    message: string;
-    args: any[];
-    stackTrace?: StackTrace;
-    source: 'plugin' | 'figma' | 'page' | 'unknown';
-    workerUrl?: string;
-}
-/**
- * Stack trace information
- */
-export interface StackTrace {
-    callFrames: CallFrame[];
-}
-/**
- * Individual stack frame
- */
-export interface CallFrame {
-    functionName: string;
-    url: string;
-    lineNumber: number;
-    columnNumber: number;
-}
-/**
- * Screenshot metadata
- */
-export interface Screenshot {
-    id: string;
-    timestamp: number;
-    path: string;
-    format: 'png' | 'jpeg';
-    width: number;
-    height: number;
-    selector?: string;
-    base64?: string;
-    metadata?: ScreenshotMetadata;
-}
-/**
- * Additional screenshot metadata
- */
-export interface ScreenshotMetadata {
-    pluginName?: string;
-    pluginId?: string;
-    figmaFileKey?: string;
-}
-/**
- * Plugin context information
- */
-export interface PluginContext {
-    pluginId?: string;
-    pluginName?: string;
-    isRunning: boolean;
-    lastReloadTime?: number;
-}
 /**
  * Server configuration
  */
 export interface ServerConfig {
-    mode: 'local' | 'cloudflare';
-    browser: BrowserConfig;
-    console: ConsoleConfig;
-    screenshots: ScreenshotConfig;
+    mode: 'local';
     local?: LocalModeConfig;
 }
-/**
- * Browser configuration
- */
-export interface BrowserConfig {
-    headless: boolean;
-    args: string[];
-    executablePath?: string;
-}
 /**
  * Local mode configuration
  */
 export interface LocalModeConfig {
-    debugHost: string;
-    debugPort: number;
-    /** Plugin bridge WebSocket server port (no CDP needed when plugin connects) */
+    /** Plugin bridge WebSocket server port (default: 5454) */
     pluginBridgePort?: number;
     /** Optional audit log file path (enterprise); one JSON object per line (NDJSON) */
     auditLogPath?: string;
 }
-/**
- * Console monitoring configuration
- */
-export interface ConsoleConfig {
-    bufferSize: number;
-    filterLevels: ConsoleLogEntry['level'][];
-    truncation: TruncationConfig;
-}
-/**
- * Screenshot configuration
- */
-export interface ScreenshotConfig {
-    defaultFormat: 'png' | 'jpeg';
-    quality: number;
-    storePath: string;
-}
-/**
- * Log truncation configuration
- */
-export interface TruncationConfig {
-    maxStringLength: number;
-    maxArrayLength: number;
-    maxObjectDepth: number;
-    removeDuplicates: boolean;
-}
 //# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/core/version.d.ts

@@ -0,0 +1,3 @@
+/** F-MCP version — keep in sync with package.json during version bumps. */
+export declare const FMCP_VERSION = "1.7.23";
+//# sourceMappingURL=version.d.ts.map

package/dist/core/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,YAAY,WAAW,CAAC"}

package/dist/core/version.js

@@ -0,0 +1,3 @@
+/** F-MCP version — keep in sync with package.json during version bumps. */
+export const FMCP_VERSION = "1.7.23";
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC"}

package/dist/local-plugin-only.js

@@ -89,7 +89,7 @@ export async function main() {
     bridge.start();
     const server = new McpServer({
         name: "F-MCP ATezer Bridge (Plugin-only)",
-        version: "1.7.19",
+        version: "1.7.24",
     });
     // ---- figma_list_connected_files (multi-client discovery) ----
     server.registerTool("figma_list_connected_files", {

package/f-mcp-plugin/README.md

@@ -10,12 +10,12 @@ This plugin enables AI assistants like Claude Code and Claude Desktop to access
 
 **For Variables (pre-loaded):**
 ```
-Figma Plugin Worker → postMessage → Plugin UI Iframe → window object → Puppeteer → MCP Server
+Figma Plugin Worker → postMessage → Plugin UI Iframe → WebSocket → MCP Server
 ```
 
 **For Components (on-demand):**
 ```
-MCP Request → Plugin UI → postMessage → Plugin Worker → figma.getNodeByIdAsync() → Returns with description
+MCP Request → WebSocket → Plugin UI → postMessage → Plugin Worker → figma.getNodeByIdAsync() → Returns with description
 ```
 
 **Key Features:**
@@ -40,9 +40,9 @@ The plugin runs in **both** Figma Design and Dev Mode (`"editorType": ["figma",
 
 So: Design vs Dev mode does **not** block MCP. Users with only Dev Mode access can run the plugin and use all read-only MCP tools.
 
-### Plugin Bridge (no Figma debug port)
+### Plugin Bridge (WebSocket)
 
-You can use MCP **without** launching Figma with a debug port. When the plugin runs, it connects to the MCP server over WebSocket (`ws://127.0.0.1:5454`). No `--remote-debugging-port=9222` needed.
+When the plugin runs, it connects to the MCP server over WebSocket (`ws://127.0.0.1:5454`).
 
 1. Start Claude (or your MCP client) so the MCP server is running (it starts the bridge server on port 5454).
 2. Open Figma **normally** (no special launch args).
@@ -61,7 +61,7 @@ The bridge is **one** WebSocket server on **one** port (default **5454**). It su
 
 ### Plugin-only mode (recommended: no REST API, no token)
 
-You can run **without** the full MCP server (figma-mcp-bridge) and **without** any Figma REST API token:
+Run **without** any Figma REST API token:
 
 1. Use the **plugin-only MCP relay**: `node dist/local-plugin-only.js` (or add it to Claude as the only MCP server).
 2. All data comes from the plugin: variables, file structure, components, styles, execute, screenshot. No `FIGMA_ACCESS_TOKEN` needed.
@@ -124,7 +124,7 @@ The plugin will:
    ```
 3. **Restart Claude.** Then open Figma, run **Plugins → Development → F-MCP ATezer Bridge**. When the plugin shows "ready", ask Claude e.g. "Figma'daki variable'ları listele" or "design system özetini ver".
 
-No Figma REST API token or debug port required.
+No Figma REST API token required.
 
 ### Accessing Data via MCP
 
@@ -179,18 +179,12 @@ figma_get_component({
 4. Resolves promise when `COMPONENT_DATA` message received
 5. Includes 10-second timeout and error handling
 
-### MCP connection: WebSocket (default) or CDP
+### MCP connection: WebSocket
 
-**WebSocket (plugin-only, no debug port):**
 1. Plugin UI connects to MCP server at `ws://127.0.0.1:5454`
 2. MCP sends RPCs (getVariables, getComponent, execute, etc.) over the WebSocket
 3. No Figma debug port or token required
 
-**CDP (optional, for console logs):**
-1. When using `local.js` and Figma started with `--remote-debugging-port=9222`, MCP can connect via Puppeteer
-2. Enumerates plugin UI iframes and reads `window.__figmaVariablesData` / calls `window.requestComponentData(nodeId)`
-3. Returns variables and component data to MCP tools
-
 ## Troubleshooting
 
 ### Plugin doesn't appear in menu
@@ -201,8 +195,7 @@ figma_get_component({
 ### "No plugin UI found with variables data" or "No plugin UI found with requestComponentData"
 - Ensure plugin is running (check for open plugin window showing "✓ F-MCP ATezer Bridge active" or "ready")
 - Try closing and reopening the plugin
-- **Plugin-only (WebSocket):** Ensure MCP server is running and nothing else is using port 5454; open Figma normally (debug port not required)
-- **CDP mode:** If using debug port, verify Figma was launched with `--remote-debugging-port=9222`
+- Ensure MCP server is running and nothing else is using port 5454; open Figma normally
 
 ### Variables not updating
 - Close and reopen the plugin to refresh data

package/f-mcp-plugin/manifest.json

@@ -29,9 +29,7 @@
       "http://localhost:5468", "ws://localhost:5468",
       "http://localhost:5469", "ws://localhost:5469",
       "http://localhost:5470", "ws://localhost:5470",
-      "https://figma-mcp-bridge.workers.dev",
-      "wss://figma-mcp-bridge.workers.dev"
     ],
-    "reasoning": "Local MCP WebSocket (5454–5470) and optional FMCP Cloud Mode (Workers); add your custom worker host here if different."
+    "reasoning": "Local MCP WebSocket (5454–5470); add your custom host here if different."
   }
 }

package/package.json

@@ -1,12 +1,11 @@
 {
 	"name": "@atezer/figma-mcp-bridge",
-	"version": "1.7.22",
+	"version": "1.7.24",
 	"description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
 	"type": "module",
-	"main": "dist/local.js",
-	"types": "dist/local.d.ts",
+	"main": "dist/local-plugin-only.js",
+	"types": "dist/local-plugin-only.d.ts",
 	"bin": {
-		"figma-mcp-bridge": "./dist/local.js",
 		"figma-mcp-bridge-plugin": "./dist/local-plugin-only.js"
 	},
 	"files": [
@@ -14,11 +13,6 @@
 		"dist/local-plugin-only.js.map",
 		"dist/local-plugin-only.d.ts",
 		"dist/local-plugin-only.d.ts.map",
-		"dist/local.js",
-		"dist/local.js.map",
-		"dist/local.d.ts",
-		"dist/local.d.ts.map",
-		"dist/browser",
 		"dist/core",
 		"f-mcp-plugin",
 		"README.md",
@@ -26,23 +20,15 @@
 		"LICENSE"
 	],
 	"scripts": {
-		"prepublishOnly": "npm run build:local && npm run validate:fmcp-skills",
-		"deploy": "wrangler deploy",
-		"dev": "wrangler dev",
-		"dev:local": "tsx src/local.ts",
-		"dev:plugin-only": "node dist/local-plugin-only.js",
-		"build:run": "npm run build:local && node dist/local-plugin-only.js",
-		"figma:debug": "./scripts/auto-launch-figma-plugin.sh",
-		"build": "npm run build:local && npm run build:cloudflare",
-		"build:local": "tsc -p tsconfig.local.json",
-		"build:cloudflare": "tsc -p tsconfig.cloudflare.json",
-		"start": "wrangler dev",
+		"prepublishOnly": "npm run build && npm run validate:fmcp-skills",
+		"dev": "node dist/local-plugin-only.js",
+		"build:run": "npm run build && node dist/local-plugin-only.js",
+		"build": "tsc -p tsconfig.local.json",
 		"test": "jest",
 		"test:watch": "jest --watch",
 		"test:coverage": "jest --coverage",
 		"format": "biome format --write",
 		"lint:fix": "biome lint --fix",
-		"cf-typegen": "wrangler types",
 		"type-check": "tsc --noEmit",
 		"validate:fmcp-skills": "node scripts/validate-fmcp-skills-tools.mjs",
 		"check-ports": "bash scripts/check-ports.sh"
@@ -71,18 +57,10 @@
 	"engines": {
 		"node": ">=18.0.0"
 	},
-	"overrides": {
-		"agents": {
-			"@modelcontextprotocol/sdk": "1.25.3"
-		}
-	},
 	"dependencies": {
-		"@cloudflare/puppeteer": "^1.0.4",
 		"@modelcontextprotocol/sdk": "^1.25.3",
-		"agents": "^0.2.8",
 		"pino": "^9.5.0",
 		"pino-pretty": "^13.0.0",
-		"puppeteer-core": "^23.11.1",
 		"ws": "^8.19.0",
 		"zod": "^3.25.76"
 	},
@@ -94,7 +72,6 @@
 		"jest": "^29.7.0",
 		"ts-jest": "^29.2.5",
 		"tsx": "^4.19.2",
-		"typescript": "5.9.3",
-		"wrangler": "^4.42.0"
+		"typescript": "5.9.3"
 	}
 }