عن المشروع

ينفذ TalkToFigma جسر بروتوكول سياق النموذج (MCP) بين وكلاء الذكاء الاصطناعي (Cursor وClaude Code وCodex) وFigma. من خلال خادم WebSocket وإضافة Figma مرافقة، يمكن للوكيل فحص المستندات والتحديدات، وإنشاء العقد وتحريرها، وإدارة النصوص والتخطيط التلقائي والأنماط والمكونات والتعليقات التوضيحية، وتصدير العقد كصور. البنية المعمارية - src/talk_to_figma_mcp: خادم MCP بلغة TypeScript يعرض عمليات Figma كأدوات. - src/cursor_mcp_plugin: إضافة Figma تتواصل مع جانب الوكيل. - src/socket.ts: خادم WebSocket ينقل الرسائل بين خادم MCP والإضافة. الإعداد ثبّت Bun، وشغّل `bun setup` (الذي يسجل أيضاً خادم MCP في مشروع Cursor النشط)، وابدأ تشغيل المقبس باستخدام `bun socket`، ثم ثبّت إضافة Figma من صفحة المجتمع أو اربطها محلياً عبر manifest.json. يستخدم الإعداد اليدوي لـ MCP الأمر `bunx cursor-talk-to-figma-mcp@latest` في ~/.cursor/mcp.json. يوضح دليل Windows + WSL ضرورة إلغاء التعليق على hostname 0.0.0.0 في socket.ts. سير الاستخدام ابدأ تشغيل خادم 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 وcreate_connections لخطوط موصلات FigJam. - الإنشاء: 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.