Figma MCP Server

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.

Integrations

  • Allows analyzing Figma file structures by extracting node hierarchies through the Figma API

Servidor MCP de Figma

Un servidor MCP (Protocolo de contexto de modelo) para analizar estructuras de archivos de Figma.

Características

  • Analizar archivos de Figma para extraer jerarquías de nodos
  • Admite tanto la API REST como el protocolo MCP
  • Profundidad del árbol de nodos configurable

Prerrequisitos

  • Node.js 16+
  • npm o hilo
  • Una clave API de Figma

Instalación

De npm

npm install -g figma-mcp-server

De la fuente

git clone https://github.com/yourusername/mcp-figma.git cd mcp-figma npm install npm run build

Configuración

Copie el archivo de entorno de ejemplo y agregue su clave API de Figma:

cp .env.example .env

Luego edita el archivo .env y agrega tu clave API de Figma:

FIGMA_API_KEY=your_figma_api_key_here

Puede obtener una clave API de Figma desde la configuración de su cuenta de Figma: https://www.figma.com/developers/api#access-tokens

Uso

Como servidor API REST

Iniciar el servidor:

npm start

Esto iniciará un servidor Express en el puerto 3000 (o el puerto especificado en su archivo .env ).

Puntos finales de API

  • GET /health - Punto final de comprobación de estado
  • GET /openapi.json - Especificación de OpenAPI
  • GET /mcp.json - Manifiesto de MCP
  • POST /analyze - Analizar un archivo de Figma

Ejemplo de solicitud al punto final de análisis:

curl -X POST http://localhost:3000/analyze \ -H "Content-Type: application/json" \ -d '{"figmaUrl": "https://www.figma.com/file/FILE_ID/PROJECT_NAME?node-id=NODE_ID", "depth": 2}'

Como servidor MCP

El servidor puede ser utilizado directamente por un LLM a través del protocolo MCP:

figma-mcp-server --cli

O si se ejecuta desde la fuente:

npm run start -- --cli

Ejemplo de cliente

Se incluye un ejemplo sencillo de cliente. Para usarlo:

node client-example.js https://www.figma.com/file/FILE_ID/PROJECT_NAME?node-id=NODE_ID 2

El último parámetro es el parámetro de profundidad opcional.

Desarrollo

Ejecutando en modo de desarrollo

npm run dev

Pruebas

npm test

Estibador

Se proporciona un Dockerfile para la implementación en contenedores:

docker build -t figma-mcp-server . docker run -p 3000:3000 --env-file .env figma-mcp-server

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

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

Facilita el análisis de las estructuras de archivos de Figma mediante la extracción de jerarquías de nodos, accesibles a través de la API REST o el protocolo MCP.

  1. Features
    1. Prerequisites
      1. Installation
        1. From npm
        2. From source
      2. Configuration
        1. Usage
          1. As a REST API Server
          2. As an MCP Server
          3. Client Example
        2. Development
          1. Running in Development Mode
          2. Testing
        3. Docker
          1. License
            ID: 4xg15vn8hw