انتقل إلى المحتوى
fontstay.dev
الشيفرة المصدرية على GitHub
السمة
محاكاة الرؤية

لفحص التصميم فقط؛ لا يصحح رؤية الألوان.

وسائل مساعدة للقراءة

خادم MCP

تتضمن حزمة fontstay خادم Model Context Protocol. يستطيع وكيل ذكاء اصطناعي في محررك قراءة ملفات الخطوط المحلية، واختيار الخطوط البديلة لجمهورك، وكتابة شيفرة CSS نفسها التي ينتجها هذا التطبيق.

ماذا يفعل

يعمل الخادم على جهازك عبر stdio. يقرأ فقط ملفات الخطوط التي يسمّيها الوكيل، ولا يكتب شيئًا ولا يجري أي طلبات شبكة. وهو بلا حالة: كل استدعاء يسمّي ملفاته ويحمل جمهوره الخاص، فيستطيع الوكيل السؤال مجددًا بخيارات مختلفة.

الأدوات

يوفّر الخادم أربع أدوات للقراءة فقط.

تقبل كل الأدوات عدا analyze_font ملفًا واحدًا إلى 16 ملف خط (WOFF2 أو WOFF أو TTF أو OTF، حتى 10 ميغابايت لكل منها) وخيارات سطر الأوامر نفسها: audience (استعلام Browserslist) وsystems وlocale وkind وunicode_range وscripts. يظهر ضعف تطابق الرموز والأنظمة بلا خطوط بديلة كتحذيرات بعد النتيجة.

الإعداد

أضف الخادم إلى عميل MCP لديك. يبدأ عبر npx ويتطلب Node.js بالإصدار 24.21 أو أحدث.

claude mcp add fontstay -- npx -y fontstay mcp

إذا لم تكن الحزمة على npm بعد، فابنها في نسخة من المستودع بالأمر pnpm cli:build واستخدم node /path/to/packages/fontstay/dist/bin.js mcp بدل npx. تُحلّ مسارات الخطوط النسبية بالنسبة إلى المجلد الذي يشغّل منه المحرر الخادم.

أمثلة على الطلبات

اطلب بلغة عادية؛ يختار الوكيل الأدوات.

نتيجة نموذجية

استدعاء get_css للملف tests/fixtures/fonts/FiraSans-Regular.ttf، مقيّد بـ Windows وmacOS ومن دون وجوه إضافية لأنظمة كتابية أخرى.

استدعاء الأداة

{
  "name": "get_css",
  "arguments": {
    "paths": ["tests/fixtures/fonts/FiraSans-Regular.ttf"],
    "systems": ["windows", "macos"],
    "scripts": false
  }
}

النتيجة

@font-face {
  font-family: "Fira Sans Fallback";
  src: local("Trebuchet MS"), local("TrebuchetMS");
  size-adjust: 100.3942%;
  ascent-override: 93.1328%;
  descent-override: 26.3959%;
  line-gap-override: 0%;
}

body {
  font-family: "Fira Sans", "Fira Sans Fallback", sans-serif;
  /* Safari has no vertical overrides: match the x-height and fix the line box */
  font-size-adjust: 0.527;
  line-height: 1.4;
}

.fonts-loading {
  letter-spacing: -0.0019em;
}

الحدود

يعود الإدخال الخاطئ كخطأ من الأداة يستطيع الوكيل قراءته وتصحيحه.

المحرك نفسه متاح كأداة سطر أوامر ومكتبة Node في حزمة fontstay. واجهة سطر الأوامر ومكتبة Node