Figma MCP 서버
Figma 파일 구조를 분석하기 위한 MCP(Model Context Protocol) 서버입니다.
특징
Figma 파일을 분석하여 노드 계층 구조 추출
REST API와 MCP 프로토콜을 모두 지원합니다
구성 가능한 노드 트리 깊이
Related MCP server: FigmaMind MCP Server
필수 조건
노드.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