figma-mcp-server
This project runs a Model Context Protocol (MCP) server for Figma integration using the figma-developer-mcp package.
Prerequisites
- Node.js v20 or higher
- A Figma Personal Access Token (API key)
Installation
Install dependencies:
npm install
Running the Server
Option 1: Using Podman Compose
This project includes containerization support using Red Hat Universal Base Image (UBI) for both Apple Silicon (ARM64) and Linux (AMD64) architectures.
Prerequisites
- Podman installed
- A Figma Personal Access Token (API key)
Steps
-
Create a
.envfile in the project root:FIGMA_API_KEY=your_figma_personal_access_token_here -
Start the service:
podman-compose up -d -
Stop the service:
podman-compose down
Option 2: Using Podman Directly
Building the Container
Using the Build Script
./build-container.sh
Build with Podman
# For current architecture
podman build -t quay.io/balki404/figma-mcp-server:1.0 .
# For specific architecture
podman build --platform linux/amd64 -t fquay.io/balki404/figma-mcp-server:1.0-amd64 .
podman build --platform linux/arm64 -t quay.io/balki404/figma-mcp-server:1.0-arm64 .
Running the Container
# Run with environment variable
podman run -e FIGMA_API_KEY=your_figma_api_key_here quay.io/balki404/figma-mcp-server:1.0-arm64
# Run in detached mode with port mapping
podman run -d --name figma-mcp -p 3333:3333 -e FIGMA_API_KEY=your_figma_api_key_here quay.io/balki404/figma-mcp-server:1.0-arm64
# Run with restart policy and port mapping
podman run -d --restart=unless-stopped --name figma-mcp -p 3333:3333 -e FIGMA_API_KEY=your_figma_api_key_here quay.io/balki404/figma-mcp-server:1.0-arm64
Option 3: Direct Node.js
You can start the server directly with your Figma API key using the following command:
npx figma-developer-mcp --figma-api-key <YOUR_FIGMA_API_KEY>
Replace <YOUR_FIGMA_API_KEY> with your actual Figma Personal Access Token.
Features
- Environment-based configuration: Easy API key management through environment variables
- SSE endpoint: Server-Sent Events available at
http://localhost:3333/sse