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

Related MCP server: Figma MCP Server with Chunking

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)