Skip to main content
Glama
enesjakozh

Figma MCP Server with Chunking

by ArchimedesCrypto
GitHub
TypeScript
MIT License
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Figma MCP Server with Chunking

A Model Context Protocol (MCP) server for interacting with the Figma API, featuring memory-efficient chunking and pagination capabilities for handling large Figma files.

Overview

This MCP server provides a robust interface to the Figma API with built-in memory management features. It's designed to handle large Figma files efficiently by breaking down operations into manageable chunks and implementing pagination where necessary.

Key Features

  • Memory-aware processing with configurable limits
  • Chunked data retrieval for large files
  • Pagination support for all listing operations
  • Node type filtering
  • Progress tracking
  • Configurable chunk sizes
  • Resume capability for interrupted operations
  • Debug logging
  • Config file support

Installation

Installing via Smithery

To install Figma MCP Server with Chunking for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ArchimedesCrypto/figma-mcp-chunked --client claude

Manual Installation

# Clone the repository git clone [repository-url] cd figma-mcp-chunked # Install dependencies npm install # Build the project npm run build

Configuration

Environment Variables

  • FIGMA_ACCESS_TOKEN: Your Figma API access token

Config File

You can provide configuration via a JSON file using the --config flag:

{ "mcpServers": { "figma": { "env": { "FIGMA_ACCESS_TOKEN": "your-access-token" } } } }

Usage:

node build/index.js --config=path/to/config.json

Tools

get_file_data (New)

Retrieves Figma file data with memory-efficient chunking and pagination.

{ "name": "get_file_data", "arguments": { "fileKey": "your-file-key", "accessToken": "your-access-token", "pageSize": 100, // Optional: nodes per chunk "maxMemoryMB": 512, // Optional: memory limit "nodeTypes": ["FRAME", "COMPONENT"], // Optional: filter by type "cursor": "next-page-token", // Optional: resume from last position "depth": 2 // Optional: traversal depth } }

Response:

{ "nodes": [...], "memoryUsage": 256.5, "nextCursor": "next-page-token", "hasMore": true }

list_files

Lists files with pagination support.

{ "name": "list_files", "arguments": { "project_id": "optional-project-id", "team_id": "optional-team-id" } }

get_file_versions

Retrieves version history in chunks.

{ "name": "get_file_versions", "arguments": { "file_key": "your-file-key" } }

get_file_comments

Retrieves comments with pagination.

{ "name": "get_file_comments", "arguments": { "file_key": "your-file-key" } }

get_file_info

Retrieves file information with chunked node traversal.

{ "name": "get_file_info", "arguments": { "file_key": "your-file-key", "depth": 2, // Optional: traversal depth "node_id": "specific-node-id" // Optional: start from specific node } }

get_components

Retrieves components with chunking support.

{ "name": "get_components", "arguments": { "file_key": "your-file-key" } }

get_styles

Retrieves styles with chunking support.

{ "name": "get_styles", "arguments": { "file_key": "your-file-key" } }

get_file_nodes

Retrieves specific nodes with chunking support.

{ "name": "get_file_nodes", "arguments": { "file_key": "your-file-key", "ids": ["node-id-1", "node-id-2"] } }

Memory Management

The server implements several strategies to manage memory efficiently:

Chunking Strategy

  • Configurable chunk sizes via pageSize
  • Memory usage monitoring
  • Automatic chunk size adjustment based on memory pressure
  • Progress tracking per chunk
  • Resume capability using cursors

Best Practices

  1. Start with smaller chunk sizes (50-100 nodes) and adjust based on performance
  2. Monitor memory usage through the response metadata
  3. Use node type filtering when possible to reduce data load
  4. Implement pagination for large datasets
  5. Use the resume capability for very large files

Configuration Options

  • pageSize: Number of nodes per chunk (default: 100)
  • maxMemoryMB: Maximum memory usage in MB (default: 512)
  • nodeTypes: Filter specific node types
  • depth: Control traversal depth for nested structures

Debug Logging

The server includes comprehensive debug logging:

// Debug log examples [MCP Debug] Loading config from config.json [MCP Debug] Access token found xxxxxxxx... [MCP Debug] Request { tool: 'get_file_data', arguments: {...} } [MCP Debug] Response size 2.5 MB

Error Handling

The server provides detailed error messages and suggestions:

// Memory limit error "Response size too large. Try using a smaller depth value or specifying a node_id."" // Invalid parameters "Missing required parameters: fileKey and accessToken" // API errors "Figma API error: [detailed message]"

Troubleshooting

Common Issues

  1. Memory Errors
    • Reduce chunk size
    • Use node type filtering
    • Implement pagination
    • Specify smaller depth values
  2. Performance Issues
    • Monitor memory usage
    • Adjust chunk sizes
    • Use appropriate node type filters
    • Implement caching for frequently accessed data
  3. API Limits
    • Implement rate limiting
    • Use pagination
    • Cache responses when possible

Debug Mode

Enable debug logging for detailed information:

# Set debug environment variable export DEBUG=true

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests to our repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

メモリを考慮したチャンク化とページ区切り機能を通じて大規模な Figma ファイルを効率的に処理する Figma API と対話するためのモデル コンテキスト プロトコル サーバー。

  1. 概要
    1. 主な特徴
  2. インストール
    1. Smithery経由でインストール
    2. 手動インストール
  3. 構成
    1. 環境変数
    2. 設定ファイル
  4. ツール
    1. get_file_data（新規）
    2. リストファイル
    3. ファイルバージョンの取得
    4. get_file_comments
    5. ファイル情報を取得する
    6. get_components
    7. get_styles
    8. get_file_nodes
  5. メモリ管理
    1. チャンキング戦略
    2. ベストプラクティス
    3. 設定オプション
  6. デバッグログ
    1. エラー処理
      1. トラブルシューティング
        1. よくある問題
        2. デバッグモード
      2. 貢献
        1. ライセンス

          Related MCP Servers

          • mcp-figma

            smithery-ai
            A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that provides access to Figma API functionality, allowing AI assistants like Claude to interact with Figma files, comments, components, and team resources.
            Last updated -
            18
            62
            2

          • Figma MCP Server

            deepsuthar496
            A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that integrates with Figma's API, allowing interaction with Figma files, comments, components, projects, and webhook management.
            Last updated -
            5
            1,066
            JavaScript

          • Figma MCP Server

            1yhy
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that integrates Figma design files with AI coding tools like Cursor, Windsurf, and Cline, allowing AI tools to access and understand Figma design data for generating more accurate code.
            Last updated -
            5
            14
            TypeScript
            MIT License
            • Linux
            • Apple

          • Figma MCP Server

            mohammeduvaiz
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that connects AI tools and LLMs to Figma designs, enabling them to extract design data, analyze design systems, and generate development documentation.
            Last updated -
            144
            1
            TypeScript
            • Apple

          View all related MCP servers

          Appeared in Searches

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/ArchimedesCrypto/figma-mcp-chunked'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server