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

Figma MCP 서버

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

특징

Figma 파일을 분석하여 노드 계층 구조 추출
REST API와 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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

analyze_figma_file

REST API 또는 MCP 프로토콜을 통해 접근할 수 있는 노드 계층 구조를 추출하여 Figma 파일 구조 분석을 용이하게 합니다.

Related Resources

Reddit Discussion about this server

Figma MCP Server