Máy chủ MCP
Gói fontstay có kèm một máy chủ Model Context Protocol. Một tác nhân AI trong trình soạn thảo có thể đọc các tệp phông chữ cục bộ của bạn, chọn phông chữ dự phòng cho đối tượng người dùng của bạn và viết cùng CSS phông chữ dự phòng như ứng dụng này.
Nó làm gì
Máy chủ chạy trên máy của bạn qua stdio. Nó chỉ đọc các tệp phông chữ mà tác nhân nêu tên, không ghi gì và không gửi yêu cầu mạng nào. Nó không giữ trạng thái: mỗi lệnh gọi nêu tên tệp của nó và mang theo đối tượng người dùng riêng, nên tác nhân có thể hỏi lại với các tùy chọn khác.
Công cụ
Máy chủ cung cấp bốn công cụ chỉ đọc.
analyze_font: Mô tả một tệp phông chữ: tên, độ đậm và kiểu, loại nhận diện được, số đo theo chiều dọc, hệ chữ, số glyph, trục biến thiên, tính năng OpenType và giấy phép.suggest_fallbacks: Liệt kê phông chữ hệ thống được chọn làm phông chữ dự phòng trên mỗi hệ điều hành, tỷ lệ đối tượng người dùng của mỗi hệ thống và phần trọng số glyph của phông chữ mà các phông chữ dự phòng cùng phủ.get_css: Tạo CSS @font-face và font-family, giống hệt ứng dụng và dòng lệnh.get_export: Cùng phép điều chỉnh đó dưới dạng biến CSS, Tailwind, Next.js, Nuxt, Astro, theme.json của WordPress, Fontaine, thẻ preload hoặc script tải, kèm tên tệp gợi ý.
Mọi công cụ trừ analyze_font nhận từ một đến 16 tệp phông chữ (WOFF2, WOFF, TTF hoặc OTF, mỗi tệp tối đa 10 MB) và cùng các tùy chọn như dòng lệnh: audience (một truy vấn Browserslist), systems, locale, kind, unicode_range và scripts. Mức glyph trùng khớp thấp và các hệ thống không có phông chữ dự phòng được trả về dưới dạng cảnh báo sau kết quả.
Cài đặt
Thêm máy chủ vào MCP client của bạn. Nó khởi động bằng npx và cần Node.js 24.21 trở lên.
claude mcp add fontstay -- npx -y fontstay mcpTệp cấu hình: claude_desktop_config.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Tệp cấu hình: .cursor/mcp.json
{
"mcpServers": {
"fontstay": { "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Tệp cấu hình: .vscode/mcp.json
{
"servers": {
"fontstay": { "type": "stdio", "command": "npx", "args": ["-y", "fontstay", "mcp"] }
}
}Tệp cấu hình: ~/.codex/config.toml
[mcp_servers.fontstay]
command = "npx"
args = ["-y", "fontstay", "mcp"]Nếu gói chưa có trên npm, hãy build nó trong một bản checkout bằng pnpm cli:build và dùng node /path/to/packages/fontstay/dist/bin.js mcp làm lệnh thay cho npx. Đường dẫn tệp phông chữ tương đối được xác định theo thư mục mà trình soạn thảo khởi động máy chủ.
Lời nhắc mẫu
Hãy hỏi bằng ngôn ngữ thông thường; tác nhân sẽ chọn công cụ.
- Phân tích fonts/Inter.woff2 và cho tôi biết nó phủ những hệ chữ nào.
- Viết CSS phông chữ dự phòng cho fonts/Inter.woff2 cho người dùng Windows và macOS rồi thêm vào src/styles/fonts.css.
- Tạo theme Tailwind cho các tệp Fira Sans của tôi, rồi kiểm tra các cảnh báo.
Kết quả mẫu
Một lệnh gọi get_css cho tests/fixtures/fonts/FiraSans-Regular.ttf, giới hạn ở Windows và macOS, không có face hệ chữ bổ sung.
Lệnh gọi công cụ
{
"name": "get_css",
"arguments": {
"paths": ["tests/fixtures/fonts/FiraSans-Regular.ttf"],
"systems": ["windows", "macos"],
"scripts": false
}
}Kết quả
@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;
}Giới hạn
Đầu vào sai được trả về dưới dạng lỗi công cụ mà tác nhân có thể đọc và sửa.
- Các truy vấn đối tượng người dùng nạp tệp cấu hình hoặc thống kê dùng chung (extends, in package) bị từ chối.
- Đường dẫn mạng của Windows (\\host\share) không được đọc.
- Dịch chuyển bố cục cần trình duyệt và không khả dụng; hãy dùng ứng dụng cho việc đó.
- Máy chủ hỗ trợ các phiên bản giao thức MCP 2025-11-25, 2025-06-18, 2025-03-26 và 2024-11-05, chỉ có công cụ.
Cùng bộ máy đó có sẵn dưới dạng công cụ dòng lệnh và thư viện Node trong gói fontstay. CLI và thư viện Node