منصوبے کے بارے میں

TalkToFigma AI ایجنٹس (Cursor، Claude Code، Codex) اور Figma کے درمیان ایک Model Context Protocol (MCP) برج نافذ کرتا ہے۔ ایک WebSocket سرور اور ساتھی Figma پلگ ان کے ذریعے، ایک ایجنٹ دستاویزات اور انتخاب کا معائنہ کر سکتا ہے، نوڈز بنا اور ترمیم کر سکتا ہے، متن، آٹو لے آؤٹ، اسٹائلز، اجزاء اور تشریحات کا انتظام کر سکتا ہے، اور نوڈز کو تصاویر کے طور پر ایکسپورٹ کر سکتا ہے۔ فن تعمیر - src/talk_to_figma_mcp: TypeScript MCP سرور جو Figma آپریشنز کو ٹولز کے طور پر ظاہر کرتا ہے۔ - src/cursor_mcp_plugin: Figma پلگ ان جو ایجنٹ کی طرف سے بات کرتا ہے۔ - src/socket.ts: WebSocket سرور جو MCP سرور اور پلگ ان کے درمیان پیغامات منتقل کرتا ہے۔ سیٹ اپ Bun انسٹال کریں، `bun setup` چلائیں (جو فعال Cursor پروجیکٹ میں MCP سرور کو بھی رجسٹر کرتا ہے)، `bun socket` سے ساکٹ شروع کریں، پھر کمیونٹی پیج سے Figma پلگ ان انسٹال کریں یا manifest.json کے ذریعے اسے مقامی طور پر لنک کریں۔ دستی MCP کنفیگریشن ~/.cursor/mcp.json میں `bunx cursor-talk-to-figma-mcp@latest` استعمال کرتی ہے۔ Windows + WSL گائیڈ میں socket.ts میں hostname 0.0.0.0 کو غیر تبصرہ کرنے کا ذکر ہے۔ استعمال کا طریقہ WebSocket سرور شروع کریں، MCP سرور انسٹال کریں، Figma کھولیں اور پلگ ان چلائیں، `join_channel` سے ایک چینل میں شامل ہوں، پھر ایجنٹ سے کمانڈز جاری کریں۔ بہترین طریقوں میں پہلے چینل میں شامل ہونا، ترمیم سے پہلے دستاویز کی معلومات اور انتخاب پڑھنا، get_node_info سے تصدیق کرنا، اور بڑے ڈیزائنز کے لیے بیچ آپریشنز استعمال کرنا شامل ہے۔ ٹول کوریج - دستاویز اور انتخاب: get_document_info، get_selection، read_my_design، get_node_info، get_nodes_info، set_focus، set_selections۔ - تشریحات: get_annotations، set_annotation، set_multiple_annotations، scan_nodes_by_types۔ - پروٹو ٹائپنگ: get_reactions، set_default_connector، FigJam کنیکٹر لائنوں کے لیے create_connections۔ - تخلیق: create_rectangle، create_frame، create_section، create_text۔ - متن: scan_text_nodes، set_text_content، set_multiple_text_contents۔ - آٹو لے آؤٹ: set_layout_mode، set_padding، set_axis_align، set_layout_sizing، set_item_spacing۔ - اسٹائلنگ: set_fill_color، set_stroke_color، set_corner_radius، set_image_fill۔ - تنظیم: move_node، resize_node، delete_node، delete_multiple_nodes، clone_node، rename_node، set_parent۔ - اجزاء اور اسٹائلز: get_styles، get_local_components، create_component_instance، get_instance_overrides، set_instance_overrides۔ - ایکسپورٹ: export_node_as_image (PNG، JPG، SVG، PDF؛ تصویری ایکسپورٹ فی الحال base64 متن واپس کرتا ہے)۔ - کنکشن: join_channel۔ پرامپٹس مددگار پرامپٹس پیچیدہ کاموں کی رہنمائی کرتے ہیں: design_strategy، read_design_strategy، text_replacement_strategy، annotation_conversion_strategy، swap_overrides_instances، reaction_to_connector_strategy۔ قابل ذکر تعاون کردہ خصوصیات میں بلک ٹیکسٹ تبدیلی اور انسٹینس اوور رائڈ پروپیگیشن شامل ہیں۔ MIT لائسنس کے تحت لائسنس یافتہ۔