@atezer/figma-mcp-bridge 1.6.1 → 1.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +13 -25
  3. package/dist/core/plugin-bridge-server.js +1 -1
  4. package/dist/local-plugin-only.js +1 -1
  5. package/dist/local.js +1 -1
  6. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -12,6 +12,24 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) bicimine uygun
12
12
 
13
13
  Bu changelog'a ekleme oncesi surumlerin tam ayrintilari icin `git log` kullanilabilir.
14
14
 
15
+ ## [1.6.3] - 2026-04-03
16
+
17
+ ### Dokumantasyon temizligi
18
+
19
+ - **28→21 aktif dokuman:** 10 dosya arsivlendi (OAUTH_SETUP, SELF_HOSTING, DEPLOYMENT_COMPARISON, CLAUDE_DESKTOP_CONFIG, FIGMA_USE, FMCP_AGENT_CANVAS_COMPAT, RECONSTRUCTION_FORMAT, PUBLISH-PLUGIN, DEPENDENCY_LAYERS, RELEASE_NOTES_TEMPLATE + root: SECURITY_FIXES_ANALYSIS, HANDOFF_TEMPLATE)
20
+ - **Kirik link: 0** — tum referanslar guncellendi veya kaldirildi
21
+ - **README sadeleştirildi:** Dokuman tablosu kullanici odakli, gereksiz satirlar kaldirildi
22
+ - **TOOLS.md:** Agent Canvas referanslari v1.6 araclariyla guncellendi
23
+
24
+ ## [1.6.2] - 2026-04-02
25
+
26
+ ### Dokumantasyon duzeltmeleri
27
+
28
+ - README: 5 kirik archived link duzeltildi, figma_export_nodes eklendi, REST_API_GUIDE + CONTRIBUTING referanslari eklendi
29
+ - README: "33 arac" → "46 arac", tekrar eden satirlar kaldirildi
30
+ - FUTURE.md: 9 tamamlanan P0-P3 maddesi isaretlendi
31
+ - KURULUM.md: versiyon 1.2.0 → 1.6.2
32
+
15
33
  ## [1.6.1] - 2026-04-02
16
34
 
17
35
  ### Batch Export (YENi — 1 tool)
package/README.md CHANGED
@@ -10,7 +10,7 @@ Figma tasarım verilerini ve işlemlerini Model Context Protocol (MCP) ile AI as
10
10
 
11
11
  **Eski kurulum:** MCP `args` içinde `…/f-mcp-bridge/dist/...` varsa `…/<clone-kökü>/dist/...` yapın. Launch Agent, `.app` ve ayrıntılı adımlar için [KURULUM.md](KURULUM.md) içindeki **«Eski f-mcp-bridge alt yolundan geçiş»** bölümüne bakın.
12
12
 
13
- **Claude Desktop config:** `env.FIGMA_PLUGIN_BRIDGE_PORT` kullanıyorsanız Figma plugin’deki port ile aynı olmalı; tam örnekler [docs/CLAUDE_DESKTOP_CONFIG.md](docs/CLAUDE_DESKTOP_CONFIG.md).
13
+ **Claude Desktop config:** `env.FIGMA_PLUGIN_BRIDGE_PORT` kullanıyorsanız Figma plugin’deki port ile aynı olmalı; örnekler aşağıdaki [Hızlı başlangıç](#hızlı-başlangıç) bölümünde.
14
14
 
15
15
  ### Figma API token tüketmiyor
16
16
 
@@ -54,6 +54,7 @@ REST API çağrısı ve Figma'ya tasarım verisi aktarımı yoktur. Bu sayede ku
54
54
  | Keşif ve durum | `figma_search_components`, `figma_get_status`, `figma_list_connected_files`, `figma_set_port` | Bileşen arama, bağlantı kontrolü, bağlı dosya listesi (multi-client), runtime port değişimi |
55
55
  | Figma REST API (token ile) | `figma_set_rest_token`, `figma_rest_api`, `figma_get_rest_token_status`, `figma_clear_rest_token` | Token girişi, direkt REST API çağrıları (export, comments, versions), rate limit takibi, otomatik cevap kırpma (context koruması) |
56
56
  | Tasarım oluşturma | `figma_create_frame`, `figma_create_text`, `figma_create_rectangle`, `figma_create_group` | Yeni frame, metin, dikdörtgen oluşturma ve gruplama |
57
+ | Görsel export | `figma_export_nodes`, `figma_capture_screenshot` | SVG/PNG/JPG/PDF batch export (1-50 node, vektörel), screenshot |
57
58
  | Kütüphane ve tanılama | `figma_search_assets`, `figma_plugin_diagnostics` | Takım kütüphanesi arama, plugin sağlık kontrolü (uptime, bellek, bağlantı) |
58
59
 
59
60
 
@@ -93,7 +94,7 @@ Varsayılan NPM `main` ve `figma-mcp-bridge` komutu **tam mod**dur; plugin ile y
93
94
 
94
95
  | Ne | Nerede |
95
96
  | --- | --- |
96
- | **Sürüm numarası** | [`package.json`](package.json) içindeki `version` (ör. **1.6.1**) |
97
+ | **Sürüm numarası** | [`package.json`](package.json) içindeki `version` (ör. **1.6.3**) |
97
98
  | **Değişiklik özeti** | [CHANGELOG.md](CHANGELOG.md) |
98
99
  | **Yayın bildirimi** | GitHub’da [Releases](https://github.com/atezer/FMCP/releases) — *Watch* → *Custom* → *Releases* ile e-posta bildirimi |
99
100
  | **npm paketi** | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) — sürüm geçmişi npm sayfasında |
@@ -226,7 +227,7 @@ npm run dev:local
226
227
 
227
228
  ## Claude / Cursor ile bağlama (detay)
228
229
 
229
- **NPX:** Paket npm'de **@atezer/figma-mcp-bridge** adıyla yayınlı. Plugin-only için: `npx -y @atezer/figma-mcp-bridge@latest figma-mcp-bridge-plugin` (tam mod için son argümanı atlayıp varsayılan `figma-mcp-bridge` binary’si kullanılır). Bkz. [NPX-INSTALLATION.md](docs/NPX-INSTALLATION.md).
230
+ **NPX:** Paket npm’de **@atezer/figma-mcp-bridge** adıyla yayınlı. Plugin-only için: `npx -y @atezer/figma-mcp-bridge@latest figma-mcp-bridge-plugin` (tam mod için son argümanı atlayıp varsayılan `figma-mcp-bridge` binary’si kullanılır).
230
231
 
231
232
  **Tam mod (console/screenshot):** Config'te `dist/local-plugin-only.js` yerine `dist/local.js` kullanın; Figma'yı `--remote-debugging-port=9222` ile açın.
232
233
 
@@ -301,20 +302,20 @@ figma_get_design_context { "figmaUrl": "https://www.figma.com/board/XYZ/...", "d
301
302
  figma_get_design_context { "fileKey": "abc123...", "depth": 2 }
302
303
  ```
303
304
 
304
- **Plugin–MCP bağlantı özeti:** İki mod var; debug portu zorunlu değil. **Plugin-only (önerilen):** Config'te `dist/local-plugin-only.js`, Figma normal açılır, token yok. **Tam mod:** Config'te `dist/local.js`, Figma `--remote-debugging-port=9222` ile açılır (console/screenshot için). Ayrıntı: [PLUGIN-MCP-BAGLANTI.md](docs/PLUGIN-MCP-BAGLANTI.md).
305
+ **Plugin–MCP bağlantı özeti:** İki mod var; debug portu zorunlu değil. **Plugin-only (önerilen):** Config'te `dist/local-plugin-only.js`, Figma normal açılır, token yok. **Tam mod:** Config'te `dist/local.js`, Figma `--remote-debugging-port=9222` ile açılır (console/screenshot için).
305
306
 
306
307
  ## Detaylı Rehber
307
308
 
308
309
  Plugin'in MCP ile nasıl konuştuğu, veri akışı, Design/Dev mode ve sorun giderme için:
309
310
 
310
311
  - **[Windows kurulum rehberi](docs/WINDOWS-INSTALLATION.md)** — Windows 10/11, Node veya Python bridge, Claude config, port, sorun giderme
311
- - **[Plugin–MCP Bağlantı Rehberi](docs/PLUGIN-MCP-BAGLANTI.md)** (mimari, kurulum, sözleşmeler)
312
- - **[Plugin Nasıl Çalışır?](docs/PLUGIN-NASIL-CALISIR.md)** (Worker/UI akışı, WebSocket vs CDP)
312
+ - **[REST API Rehberi](docs/REST_API_GUIDE.md)** — Token kurulumu, örnekler, rate limit yönetimi
313
+ - **[Katkıda Bulunma](CONTRIBUTING.md)** — Geliştirici rehberi, test, tool ekleme
313
314
 
314
315
  ## Repo İçeriği
315
316
 
316
317
  - `f-mcp-plugin/` – F-MCP ATezer Bridge plugin kaynağı (manifest, code.js, ui.html)
317
- - `docs/` – Kurulum, mod karşılaştırma, [Plugin nasıl çalışır](docs/PLUGIN-NASIL-CALISIR.md), sorun giderme
318
+ - `docs/` – Kurulum, araç referansı, REST API rehberi, sorun giderme
318
319
  - `src/` – MCP sunucusu (local, plugin-only, Cloudflare Worker)
319
320
  - `python-bridge/` – **Python MCP bridge** (Node.js kurulumu olmayan ortamlar için); aynı WebSocket protokolü, port 5454
320
321
 
@@ -326,31 +327,18 @@ Plugin'in MCP ile nasıl konuştuğu, veri akışı, Design/Dev mode ve sorun gi
326
327
  | [ONBOARDING.md](docs/ONBOARDING.md) | **Kurulum rehberi (Onboarding)** — Plugin yükle, Node.js, MCP başlat, Claude config |
327
328
  | [WINDOWS-INSTALLATION.md](docs/WINDOWS-INSTALLATION.md) | **Windows kurulum** — Node veya Python bridge, Claude config (Windows yolu), port, sorun giderme |
328
329
  | [SETUP.md](docs/SETUP.md) | Kurulum (Remote / Local) |
329
- | [PLUGIN-MCP-BAGLANTI.md](docs/PLUGIN-MCP-BAGLANTI.md) | Plugin–MCP mimari ve kurulum |
330
- | [PLUGIN-NASIL-CALISIR.md](docs/PLUGIN-NASIL-CALISIR.md) | Plugin Worker/UI akışı |
331
- | [MODE_COMPARISON.md](docs/MODE_COMPARISON.md) | Mod karşılaştırma |
332
- | [TOOLS.md](docs/TOOLS.md) | MCP araçları referansı |
333
- | [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md) | **33 araç tam liste** (referans, Claude ile doğrulanmış) |
330
+ | [TOOLS.md](docs/TOOLS.md) | MCP araçları detaylı referansı |
331
+ | [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md) | **46 araç tam liste** (referans, Claude ile doğrulanmış) |
332
+ | [REST_API_GUIDE.md](docs/REST_API_GUIDE.md) | **REST API rehberi** — Token kurulumu, örnekler, rate limit |
333
+ | [CONTRIBUTING.md](CONTRIBUTING.md) | **Katkıda bulunma** — Yerel kurulum, test, tool ekleme, PR süreci |
334
334
  | [DEVELOPER_FIGMA_CAPABILITIES.md](docs/DEVELOPER_FIGMA_CAPABILITIES.md) | **Cursor + F-MCP:** Neyi alır/almaz, birebir çıkartma, code-ready/SUI/token referansı, ileride |
335
335
  | [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | Sorun giderme |
336
- | [NPX-INSTALLATION.md](docs/NPX-INSTALLATION.md) | NPX ile kurulum |
337
336
  | [CHANGELOG.md](CHANGELOG.md) | **Sürüm geçmişi** — npm/GitHub Releases ile birlikte referans |
338
- | [RELEASE_NOTES_TEMPLATE.md](docs/RELEASE_NOTES_TEMPLATE.md) | **Yeni sürüm yayını** — GitHub Release gövdesi şablonu ve `gh release create` ipuçları |
339
- | [OAUTH_SETUP.md](docs/OAUTH_SETUP.md) | OAuth (remote sunucu) |
340
- | [SELF_HOSTING.md](docs/SELF_HOSTING.md) | Kendi sunucunda host |
341
- | [DEPLOYMENT_COMPARISON.md](docs/DEPLOYMENT_COMPARISON.md) | Dağıtım karşılaştırma |
342
337
  | [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Teknik mimari |
343
338
  | [USE_CASES.md](docs/USE_CASES.md) | Örnek kullanım senaryoları |
344
- | [RECONSTRUCTION_FORMAT.md](docs/RECONSTRUCTION_FORMAT.md) | Reconstruction format |
345
- | [BITBUCKET-README.md](docs/BITBUCKET-README.md) | Bitbucket README şablonu |
346
- | [PORT-5454-KAPALI.md](docs/PORT-5454-KAPALI.md) | Port 5454 kapalı sorun giderme |
347
339
  | [MULTI_INSTANCE.md](docs/MULTI_INSTANCE.md) | **Paralel görevler & çoklu kullanıcı** — sabit port, paralel hatlar, Claude çoklu MCP |
348
- | [CLAUDE_DESKTOP_CONFIG.md](docs/CLAUDE_DESKTOP_CONFIG.md) | Claude Desktop config örnekleri (tek ve çoklu MCP sunucusu) |
349
- | [DEPENDENCY_LAYERS.md](docs/DEPENDENCY_LAYERS.md) | Bağımlılık katmanları (plugin-only / tam / Cloudflare) ve olası paket ayrımı taslağı |
350
340
  | [ENTERPRISE.md](docs/ENTERPRISE.md) | **Enterprise** — Audit log, air-gap, Organization plugin |
351
- | [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md) | **Güvenlik denetimi** — bulgular checklist ([FUTURE.md](FUTURE.md) §10) |
352
- | [PUBLISH-PLUGIN.md](docs/PUBLISH-PLUGIN.md) | **Publish plugin** — Figma'da yayınlama: Data security cevapları, final details, Plugin ID |
353
- | | |
341
+ | [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md) | **Güvenlik denetimi** — bulgular checklist |
354
342
 
355
343
 
356
344
  ## Yaygınlaştırma: Organization (private) plugin
package/dist/core/plugin-bridge-server.js CHANGED
@@ -247,7 +247,7 @@ export class PluginBridgeServer {
247
247
  logger.info({ clientId, fileKey: incomingFileKey, fileName: incomingFileName }, "Plugin bridge: client registered (fileKey=%s, fileName=%s)", incomingFileKey, incomingFileName);
248
248
  ws.send(JSON.stringify({
249
249
  type: "welcome",
250
- bridgeVersion: "1.6.1",
250
+ bridgeVersion: "1.6.3",
251
251
  port: this.port,
252
252
  clientId,
253
253
  multiClient: true,
package/dist/local-plugin-only.js CHANGED
@@ -89,7 +89,7 @@ export async function main() {
89
89
  bridge.start();
90
90
  const server = new McpServer({
91
91
  name: "F-MCP ATezer Bridge (Plugin-only)",
92
- version: "1.6.1",
92
+ version: "1.6.3",
93
93
  });
94
94
  // ---- figma_list_connected_files (multi-client discovery) ----
95
95
  server.registerTool("figma_list_connected_files", {
package/dist/local.js CHANGED
@@ -48,7 +48,7 @@ class LocalFigmaMCP {
48
48
  this.variablesCache = new Map();
49
49
  this.server = new McpServer({
50
50
  name: "F-MCP ATezer (Local)",
51
- version: "1.6.1",
51
+ version: "1.6.3",
52
52
  });
53
53
  }
54
54
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atezer/figma-mcp-bridge",
3
- "version": "1.6.1",
3
+ "version": "1.6.3",
4
4
  "description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
5
5
  "type": "module",
6
6
  "main": "dist/local.js",