خادم MCP
تتضمن حزمة fontstay خادم Model Context Protocol. يستطيع وكيل ذكاء اصطناعي في محررك قراءة ملفات الخطوط المحلية، واختيار الخطوط البديلة لجمهورك، وكتابة شيفرة CSS نفسها التي ينتجها هذا التطبيق.
ماذا يفعل
يعمل الخادم على جهازك عبر stdio. يقرأ فقط ملفات الخطوط التي يسمّيها الوكيل، ولا يكتب شيئًا ولا يجري أي طلبات شبكة. وهو بلا حالة: كل استدعاء يسمّي ملفاته ويحمل جمهوره الخاص، فيستطيع الوكيل السؤال مجددًا بخيارات مختلفة.
الأدوات
يوفّر الخادم أربع أدوات للقراءة فقط.
analyze_font: يصف ملف خط: الأسماء والوزن والنمط والنوع المكتشف والمقاييس الرأسية والأنظمة الكتابية وعدد الرموز والمحاور المتغيرة وميزات OpenType والترخيص.suggest_fallbacks: يعرض خط النظام المختار بديلًا في كل نظام تشغيل، وحصة كل نظام في الجمهور، ومقدار وزن رموز الخط الذي تشترك فيه البدائل معه.get_css: يولّد شيفرة CSS لـ @font-face وfont-family، مطابقة لما ينتجه التطبيق وسطر الأوامر.get_export: الضبط نفسه بصيغة متغيرات CSS أو Tailwind أو Next.js أو Nuxt أو Astro أو theme.json لووردبريس أو Fontaine أو وسوم preload أو سكربت تحميل، مع اسم ملف مقترح.
تقبل كل الأدوات عدا 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ملف الإعداد: claude_desktop_config.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}ملف الإعداد: .cursor/mcp.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}ملف الإعداد: .vscode/mcp.json
{
"servers": {
"fontstay": { "type": "stdio", "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}ملف الإعداد: ~/.codex/config.toml
[mcp_servers.fontstay]
command = "npx"
args = ["-y", "fontstay", "mcp"]إذا لم تكن الحزمة على npm بعد، فابنها في نسخة من المستودع بالأمر pnpm cli:build واستخدم node /path/to/packages/fontstay/dist/bin.js mcp بدل npx. تُحلّ مسارات الخطوط النسبية بالنسبة إلى المجلد الذي يشغّل منه المحرر الخادم.
أمثلة على الطلبات
اطلب بلغة عادية؛ يختار الوكيل الأدوات.
- حلّل fonts/Inter.woff2 وأخبرني بالأنظمة الكتابية التي يغطيها.
- اكتب CSS للخطوط البديلة لـ fonts/Inter.woff2 لمستخدمي Windows وmacOS وأضفه إلى src/styles/fonts.css.
- ولّد سمة Tailwind لملفات Fira Sans لديّ ثم راجع التحذيرات.
نتيجة نموذجية
استدعاء 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;
}الحدود
يعود الإدخال الخاطئ كخطأ من الأداة يستطيع الوكيل قراءته وتصحيحه.
- تُرفض استعلامات الجمهور التي تحمّل إعدادًا مشتركًا أو ملف إحصاءات (extends وin package).
- لا تُقرأ مسارات شبكة Windows (\\host\share).
- يحتاج انزياح التخطيط إلى متصفح فهو غير متاح هنا؛ استخدم التطبيق.
- يدعم الخادم إصدارات بروتوكول MCP 2025-11-25 و2025-06-18 و2025-03-26 و2024-11-05، أدوات فقط.
المحرك نفسه متاح كأداة سطر أوامر ومكتبة Node في حزمة fontstay. واجهة سطر الأوامر ومكتبة Node