Figma MCP 서버

Figma 파일 구조를 분석하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

• Figma 파일을 분석하여 노드 계층 구조 추출

• REST API와 MCP 프로토콜을 모두 지원합니다

• 구성 가능한 노드 트리 깊이

Related MCP server: Figma MCP

필수 조건

• 노드.js 16+

• npm 또는 yarn

• Figma API 키

설치

npm에서

지엑스피1

출처에서

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

구성

예제 환경 파일을 복사하고 Figma API 키를 추가하세요.

cp .env.example .env

그런 다음 .env 파일을 편집하고 Figma API 키를 추가하세요.

FIGMA_API_KEY=your_figma_api_key_here

Figma 계정 설정에서 Figma API 키를 얻을 수 있습니다: https://www.figma.com/developers/api#access-tokens

용법

REST API 서버로서

서버를 시작합니다:

npm start

이렇게 하면 포트 3000(또는 .env 파일에 지정된 포트)에서 Express 서버가 시작됩니다.

API 엔드포인트

• GET /health - 상태 확인 엔드포인트

• GET /openapi.json - OpenAPI 사양

• GET /mcp.json - MCP 매니페스트

• POST /analyze - Figma 파일 분석

분석 엔드포인트에 대한 요청 예:

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}'

MCP 서버로서

LLM은 MCP 프로토콜을 통해 서버를 직접 사용할 수 있습니다.

figma-mcp-server --cli

또는 소스에서 실행하는 경우:

npm run start -- --cli

클라이언트 예

간단한 클라이언트 예제가 포함되어 있습니다. 사용 방법은 다음과 같습니다.

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

마지막 매개변수는 선택적 깊이 매개변수입니다.

개발

개발 모드에서 실행

npm run dev

테스트

npm test

도커

컨테이너화된 배포를 위해 Dockerfile이 제공됩니다.

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

특허

MIT