เซิร์ฟเวอร์ MCP
แพ็กเกจ fontstay มีเซิร์ฟเวอร์ Model Context Protocol รวมอยู่ด้วย เอเจนต์ AI ในเอดิเตอร์ของคุณอ่านไฟล์ฟอนต์ในเครื่อง เลือกฟอนต์สำรองสำหรับกลุ่มผู้ใช้ของคุณ และเขียน CSS ฟอนต์สำรองแบบเดียวกับแอปนี้ได้
ทำอะไรได้บ้าง
เซิร์ฟเวอร์ทำงานบนเครื่องของคุณผ่าน stdio อ่านเฉพาะไฟล์ฟอนต์ที่เอเจนต์ระบุชื่อ ไม่เขียนอะไรและไม่ส่งคำขอเครือข่าย เซิร์ฟเวอร์ไม่เก็บสถานะ: ทุกการเรียกระบุไฟล์และกลุ่มผู้ใช้ของตัวเอง เอเจนต์จึงถามซ้ำด้วยตัวเลือกอื่นได้
เครื่องมือ
เซิร์ฟเวอร์มีเครื่องมืออ่านอย่างเดียวสี่ตัว
analyze_font: อธิบายไฟล์ฟอนต์: ชื่อ น้ำหนักและสไตล์ ประเภทที่ตรวจพบ ค่าเมตริกในแนวตั้ง ระบบตัวอักษร จำนวนกลิฟ แกนแปรผัน ฟีเจอร์ OpenType และใบอนุญาตsuggest_fallbacks: แสดงรายการฟอนต์ระบบที่เลือกเป็นฟอนต์สำรองบนแต่ละระบบปฏิบัติการ สัดส่วนกลุ่มผู้ใช้ของแต่ละระบบ และสัดส่วนกลิฟ (ถ่วงน้ำหนักตามความถี่) ที่ฟอนต์สำรองมีร่วมกับฟอนต์นั้นget_css: สร้าง CSS @font-face และ font-family เหมือนกับแอปและบรรทัดคำสั่งทุกประการget_export: ผลการปรับแบบเดียวกันในรูปแบบ CSS variables, Tailwind, Next.js, Nuxt, Astro, theme.json ของ WordPress, Fontaine, แท็ก preload หรือสคริปต์โหลด พร้อมชื่อไฟล์ที่แนะนำ
เครื่องมือทั้งหมดยกเว้น analyze_font รับไฟล์ฟอนต์หนึ่งถึง 16 ไฟล์ (WOFF2, WOFF, TTF หรือ OTF ไฟล์ละไม่เกิน 10 MB) และตัวเลือกเดียวกับบรรทัดคำสั่ง: 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 โดยไม่มี face ของระบบตัวอักษรเพิ่มเติม
การเรียกเครื่องมือ
{
"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 โดยรองรับเฉพาะเครื่องมือ (tools)
เอนจินเดียวกันนี้มีให้ใช้เป็นเครื่องมือบรรทัดคำสั่งและไลบรารี Node ในแพ็กเกจ fontstay CLI และไลบรารี Node