Figma Context MCP — Cached
Provides tools for interacting with Figma designs, including preparing Figma files, retrieving design/layout/content/component data, downloading SVG/PNG assets, and managing a local cache to reduce Figma API calls.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Figma Context MCP — Cached
Phiên bản MCP hỗ trợ Figma với bộ nhớ đệm bền vững trên máy cục bộ. Dự án giúp giảm số lần gọi Figma API, tránh giới hạn tốc độ, tăng tốc độ phản hồi và làm việc ổn định hơn với các MCP client như Cursor.
Phiên bản tiếng Anh: README_EN.md
Tính năng
Bộ nhớ đệm Figma file trên đĩa.
Giảm số lần gọi Figma API.
Thiết lập thời gian sống cache bằng TTL.
Chọn thư mục cache tùy chỉnh.
Cung cấp
figma_prepare_fileđể chuẩn bị, xác thực và làm mới dữ liệu.Kiểm tra node ID trước khi truy xuất thiết kế.
Cung cấp
forceRefreshđể bỏ qua cache và lấy dữ liệu mới nhất.Tải SVG/PNG vào thư mục Downloads hoặc thư mục do người dùng chọn.
Caching theo mức node và cache LRU trong bộ nhớ.
Tự động xóa cache hết hạn.
Xem và dọn cache qua MCP tools.
Hỗ trợ mã hóa cache tùy chọn bằng AES-256-CBC.
Hỗ trợ vận hành qua stdio hoặc HTTP.
Related MCP server: Figma MCP local
Cài đặt và cấu hình nhanh
1. Tạo Figma Personal Access Token
Mở Figma Developer Settings, tạo Personal Access Token và giữ token riêng tư.
2. Thêm MCP server vào Cursor
{
"mcpServers": {
"Figma-Context-MCP-Cached": {
"command": "npx",
"args": [
"-y",
"@pactortester/figma-mcp-cached",
"--stdio",
"--figma-api-key=FIGMA_PERSONAL_ACCESS_TOKEN",
"--figma-caching={\"ttl\":{\"value\":7,\"unit\":\"d\"}}"
]
}
}
}Ví dụ trên bật cache với thời hạn 7 ngày.
3. Chạy tại máy phát triển
Yêu cầu Node.js 18 trở lên và pnpm.
pnpm install
pnpm build
pnpm start -- --stdio --figma-api-key=FIGMA_PERSONAL_ACCESS_TOKENChế độ HTTP:
pnpm start -- --figma-api-key=FIGMA_PERSONAL_ACCESS_TOKEN --port=3333Sau đó kết nối MCP client tới:
Streamable HTTP:
http://localhost:3333/mcpSSE:
http://localhost:3333/sseMessage:
http://localhost:3333/messages
Chế độ HTTP hiện không dùng xác thực MCP riêng. Chỉ chạy trên mạng tin cậy hoặc đặt bên sau reverse proxy có xác thực.
Cách xác thực
Ưu tiên biến môi trường hoặc file .env:
# Một PAT đơn lẻ — tương thích với cấu hình hiện tại
FIGMA_API_KEY=figma_personal_access_token
# PAT pool — khi một PAT bị từ chối, hết quota hoặc bị 401/403/429
# Server tự thử PAT tiếp theo theo thứ tự. Ưu tiên pool này khi được đặt.
FIGMA_API_KEYS=["figma_pat_thanh_vien_1","figma_pat_thanh_vien_2","figma_pat_thanh_vien_3"]
FIGMA_OAUTH_TOKEN=
PORT=3333
OUTPUT_FORMAT=yaml
SKIP_IMAGE_DOWNLOADS=false
FIGMA_CACHING={"ttl":{"value":7,"unit":"d"}}Cũng có thể dùng danh sách cách nhau bằng dấu phẩy:
FIGMA_API_KEYS=figma_pat_thanh_vien_1,figma_pat_thanh_vien_2,figma_pat_thanh_vien_3Hoặc truyền qua dòng lệnh:
node dist/bin.js --port=3333 --figma-api-keys='["figma_pat_1","figma_pat_2","figma_pat_3"]'Mặc định chương trình tải .env từ thư mục làm việc hiện tại. Có thể chỉ định file khác:
pnpm start -- --stdio --env=/duong-dan/den/.envCác nguồn cấu hình theo thứ tự ưu tiên:
Tham số dòng lệnh.
Biến môi trường hoặc file
.env.Giá trị mặc định.
Không chia sẻ hoặc commit FIGMA_API_KEY, FIGMA_OAUTH_TOKEN, khoá mã hóa cache hoặc file .env.
Tham số dòng lệnh
Tham số | Kiểu | Mặc định | Mô tả |
| chuỗi | — | Một Figma Personal Access Token đơn lẻ |
| chuỗi JSON hoặc danh sách cách dấu phẩy | — | Pool PAT để tự chuyển key khi PAT bị lỗi hoặc hết quota |
| chuỗi | — | Figma OAuth Bearer token |
| đường dẫn |
| File môi trường tùy chỉnh |
| số |
| Cổng HTTP |
| cờ |
| Trả dữ liệu JSON thay vì YAML |
| cờ |
| Không đăng ký công cụ tải ảnh |
| chuỗi JSON | không bật | Cấu hình cache |
| cờ | — | Chạy transport stdio |
Cấu hình cache
Bật cache bằng tham số --figma-caching hoặc biến FIGMA_CACHING:
{
"ttl": {
"value": 30,
"unit": "d"
},
"cacheDir": "~/figma-cache",
"autoCleanup": true,
"cleanupInterval": {
"value": 1,
"unit": "h"
},
"maxMemoryCacheSize": 200,
"encryptionKey": "khoa-bao-mat-khong-chia-se"
}
Cách sử dụng trong dòng lệnh:
--figma-caching={"ttl":{"value":30,"unit":"d"},"cacheDir":"~/figma-cache","autoCleanup":true,"cleanupInterval":{"value":1,"unit":"h"},"maxMemoryCacheSize":200,"encryptionKey":"khoa-bao-mat-khong-chia-se"}TTL
ttl.value là số lượng và ttl.unit nhận một trong các giá trị:
Đơn vị | Ý nghĩa |
| mili giây |
| giây |
| phút |
| giờ |
| ngày |
Các tuỳ chọn cache
Thuộc tính | Kiểu | Mặc định | Mô tả |
| object | bắt buộc | Thời hạn cache |
| chuỗi | theo hệ điều hành | Thư mục lưu cache |
| boolean |
| Tự động xóa cache hết hạn |
| object | 1 giờ | Chu kỳ chạy tự động cleanup |
| số |
| Số mục cache LRU tối đa trong bộ nhớ |
| chuỗi | không bật | Khoá mã hóa cache |
Đường dẫn cache mặc định:
Linux:
~/.cache/figma-mcpmacOS:
~/Library/Caches/FigmaMcpWindows:
%LOCALAPPDATA%\FigmaMcpCache
Không cung cấp cacheDir hoặc khóa có khoảng trắng không cần thiết. Sử dụng đường dẫn tuyệt đối nếu muốn kiểm soát dữ liệu rõ ràng.
Cách cache hoạt động
Lần đầu truy vấn một Figma file, server gọi Figma API.
Toàn bộ dữ liệu trả về được nén và lưu local.
Trong thời hạn TTL, dữ liệu được đọc từ cache thay vì gọi lại API.
Khi cache hết hạn, server gọi Figma API để làm mới dữ liệu.
figma_prepare_filecó thể kiểm tra cache và gọi lại API khi cần.
Cache phù hợp với thiết kế đã ổn định hoặc ít thay đổi. Khi dùng cache, dữ liệu có thể chưa phản ánh thay đổi mới nhất trên Figma cho đến khi cache hết hạn hoặc được làm mới thủ công.
Làm mới dữ liệu bằng cách:
Gọi
figma_prepare_filevớiforceRefresh: true.Yêu cầu AI "lấy dữ liệu Figma mới nhất".
Xóa cache tương ứng trong thư mục cache.
Gọi công cụ
cleanup_cache.
Các MCP tools
Dự án cung cấp năm công cụ MCP:
figma_prepare_file
Chuẩn bị Figma file trước khi truy xuất dữ liệu.
Tham số | Kiểu | Bắt buộc | Mô tả |
| string | Có | Figma URL có dạng |
| boolean | Không | Bỏ qua cache và lấy dữ liệu mới nhất |
Ví dụ:
{
"figmaUrl": "https://www.figma.com/design/FILE_KEY/ten-file?node-id=1234-5678",
"forceRefresh": true
}Workflow khuyến nghị:
Người dùng cung cấp URL
-> figma_prepare_file
-> get_figma_dataget_figma_data
Lấy dữ liệu thiết kế, bố cục, content, visual và component.
Tham số | Kiểu | Bắt buộc | Mô tả |
| string | Có | Key trong URL Figma |
| string | Không | Node ID, ví dụ |
| number | Không | Độ sâu truy cập node tree |
Ví dụ:
{
"fileKey": "FILE_KEY",
"nodeId": "2777:9428",
"depth": 5
}Kết quả có thể bao gồm:
metadata: thông tin file.nodes: node, layout, style và content.globalVars: biến style toàn cục.components: component definitions.componentSets: component sets.
Luôn gọi figma_prepare_file trước khi gọi get_figma_data.
download_figma_images
Tải asset PNG/SVG từ Figma.
Tham số | Kiểu | Bắt buộc | Mô tả |
| string | Có | Figma file key |
| array | Có | Danh sách node cần xuất |
| string | Không | Thư mục lưu ảnh |
| number | Không | Tỷ lệ xuất PNG, mặc định |
Mỗi phần tử trong nodes:
Trường | Kiểu | Bắt buộc | Mô tả |
| string | Có | Node ID |
| string | Có | Tên file |
| string | Không | Image fill reference |
| boolean | Không | Có cần crop theo transform không |
| array | Không | Figma transform matrix |
| boolean | Không | Có cần trả kích thước ảnh không |
Ví dụ:
{
"fileKey": "FILE_KEY",
"nodes": [
{
"nodeId": "2777-9428",
"fileName": "hero-image.png"
},
{
"nodeId": "2777-9430",
"fileName": "icon-star.svg"
}
],
"pngScale": 2
}Khi không chỉ định localPath, ảnh được lưu vào:
macOS/Linux:
~/DownloadsWindows:
C:\Users\<username>\Downloads
list_cache
Liệt kê trạng thái cache.
Tham số: không có.
Thông tin trả về:
enabled: cache có đang bật hay không.cacheDir: thư mục cache.fileCount: số file cache.totalSize: dung lượng đọc được.ttl: thời hạn cache.
cleanup_cache
Xóa cache hết hạn hoặc bị lỗi.
Tham số: không có.
Thông tin trả về:
deletedFiles: số file đã xóa.previousSize: dung lượng trước cleanup.currentSize: dung lượng sau cleanup.currentFileCount: số file còn lại.
Khuôn mẫu cấu hình MCP
Personal Access Token qua biến môi trường
{
"mcpServers": {
"Figma-Context-MCP-Cached": {
"command": "npx",
"args": [
"-y",
"@pactortester/figma-mcp-cached",
"--stdio"
],
"env": {
"FIGMA_API_KEY": "FIGMA_PERSONAL_ACCESS_TOKEN",
"FIGMA_CACHING": "{\"ttl\":{\"value\":7,\"unit\":\"d\"}}"
}
}
}
}OAuth Bearer token
{
"mcpServers": {
"Figma-Context-MCP-Cached": {
"command": "npx",
"args": [
"-y",
"@pactortester/figma-mcp-cached",
"--stdio",
"--figma-oauth-token=FIGMA_OAUTH_TOKEN"
]
}
}
}Scripts phát triển
Xem chi tiết tại SCRIPTS.md.
pnpm install # Cài dependency
pnpm dev # Chạy build/watch
pnpm dev:cli # Chạy development mode qua stdio
pnpm type-check # Kiểm tra TypeScript
pnpm lint # Chạy ESLint
pnpm test # Chạy Jest
pnpm build # Build package
pnpm start # Chạy bản buildKiểm tra bảo mật cơ bản
Không commit file
.env.Không truyền token Figma qua prompt, issue hoặc log công khai.
Tránh cung cấp
encryptionKeyhoặc cache key qua lịch sử shell.Chỉ chạy HTTP mode trên localhost hoặc mạng tin cậy.
Chỉ tải image từ URL do Figma API cấp.
Khi bật development logging, dữ liệu Figma có thể được ghi vào thư mục
logs/.Xem lại cache trước khi đóng gói máy, sao lưu hoặc chia sẻ thư mục workspace.
Nâng cấp dependency thường xuyên bằng
pnpm updatevàpnpm audit.
Ví dụ kiểm tra bảo mật:
pnpm audit --prod
pnpm type-check
pnpm test
pnpm buildCảnh báo về cache và dữ liệu
Nếu không cấu hình
FIGMA_CACHING, cache đĩa không được bật.Cache lưu dữ liệu Figma; có thể chứa text, tên node, component và metadata.
Cache mặc định chưa mã hóa dữ liệu.
Cache legacy
.jsoncó thể đã từng lưu dữ liệu dạng plaintext.Khi đặt
encryptionKey, giữ khoá an toàn vì mất khoá sẽ không đọc lại được cache.Cache có thể trả dữ liệu cũ trong thời gian TTL.
Tương thích
Tương thích với Figma Context MCP gốc.
Hỗ trợ Node.js 18 trở lên.
Có thể thay thế drop-in cho MCP client hỗ trợ stdio hoặc HTTP.
Không cần thay đổi gọi tool nếu client đã tuân thủ interface MCP.
Nhật ký thay đổi
Xem CHANGELOG.md.
Giấy phép
Dự án phát hành theo MIT License.
Cảm ơn
Dự án được phát triển dựa trên:
Cảm ơn hai dự án đã cung cấp nền tảng và ý tưởng cho implementation gốc.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
The Figma MCP server brings Figma design context directly into your AI workflow.
Jinn gateway MCP — brand DNA, brand kits, design systems, and agency tools behind one bearer token.
Create App Store screenshots, icons, ASO copy, localization, and revisions via hosted MCP.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Related MCP Servers
- AlicenseAqualityDmaintenanceCaches Figma file data locally and provides an MCP server for AI agents to search and retrieve design nodes efficiently, minimizing API calls.5MIT
- FlicenseNot gradedqualityCmaintenanceA local, high-performance replacement for the hosted Figma MCP server that caches Figma files and exposes a local MCP endpoint for Cursor or any MCP client.-
- FlicenseBqualityDmaintenanceMCP server that fetches Figma data (file trees, nodes, images, components, styles, variables) and serves as a foundation for Flutter code generation.13-
- AlicenseNot gradedqualityDmaintenanceToken-efficient Figma MCP server with image export, query DSL, and design token support.4 npmMIT