Figma MCP サーバー
Figma の API に接続し、AI ツールと LLM が Figma デザインにアクセスして操作できるようにするモデル コンテキスト プロトコル (MCP) サーバー。
特徴
- デザインデータの抽出:Figmaのデザインからコンポーネント、スタイル、テキストを抽出します
- デザインシステム分析: デザインシステムの一貫性とパターンを分析する
- UIコンテンツ管理:デザインからすべてのUIコピーを抽出して整理します
- 開発ハンドオフ: 開発者向けの包括的なドキュメントを生成する
- シームレスなAI統合:Claude、Cursor、その他のMCP互換クライアントなどのAIツールにデザインを接続
はじめる
前提条件
- Node.js 16以上
- Figma 個人アクセストークン(Figma アカウント設定から取得)
インストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/figma-mcp-server.git
cd figma-mcp-server
- 依存関係をインストールします:
- プロジェクト ルートに
.env
ファイルを作成します。FIGMA_API_TOKEN=your_figma_personal_access_token
API_KEY=your_secure_api_key
TRANSPORT_TYPE=stdio
- サーバーを構築します。
- サーバーを起動します。
クライアントへの接続
デスクトップ版クロード
- Claude for Desktop 構成ファイルを開くか作成します。
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- 次の構成を追加します。
{
"mcpServers": {
"figma": {
"command": "node",
"args": ["/absolute/path/to/figma-mcp-server/build/index.js"],
"env": {
"FIGMA_API_TOKEN": "your_figma_personal_access_token",
"TRANSPORT_TYPE": "stdio"
}
}
}
}
- デスクトップ版のClaudeを再起動する
カーソル
グローバル構成
カーソルの MCP 構成ファイルを作成または編集します。
- macOS:
~/Library/Application Support/Cursor/mcp.json
- Windows:
%APPDATA%\Cursor\mcp.json
{
"mcpServers": {
"figma-mcp": {
"url": "http://localhost:3000/sse",
"env": {
"API_KEY": "your_secure_api_key"
}
}
}
}
プロジェクト固有の構成
- プロジェクト ルートに
.cursor
ディレクトリを作成します。 - そのディレクトリ内に
mcp.json
ファイルを作成します。{
"mcpServers": {
"figma-mcp": {
"url": "http://localhost:3000/sse",
"env": {
"API_KEY": "your_secure_api_key"
}
}
}
}
利用可能なツール
道具 | 説明 |
---|
get-file-info | Figmaファイルの基本情報を取得する |
get-nodes | Figmaファイルから特定のノードを取得する |
get-components | Figmaファイルからコンポーネント情報を取得する |
get-styles | Figmaファイルからスタイル情報を取得する |
get-comments | Figmaファイルからコメントを取得する |
search-file | タイプ、名前などによって Figma ファイル内の要素を検索します。 |
extract-text | Figmaファイルからすべてのテキスト要素を抽出する |
利用可能なプロンプト
analyze-design-system
- デザインシステムのコンポーネントとスタイルの一貫性を分析するextract-ui-copy
- デザインからすべてのUIコピーを抽出して整理しますgenerate-dev-handoff
- 設計に基づいて開発ハンドオフドキュメントを生成する
使用例
Claude で使用する場合:
Can you analyze the design system in my Figma file with key abc123? Look for consistency in color usage and typography.
カーソルと併用する場合:
Generate React components for the buttons from my Figma file with key abc123, using tailwind CSS.
環境変数
変数 | 説明 | デフォルト |
---|
FIGMA_API_TOKEN | Figma個人アクセストークン | (必須) |
API_KEY | API認証用のセキュリティキー | (必須) |
TRANSPORT_TYPE | トランスポート方法( stdio またはsse ) | stdio |
PORT | SSEトランスポート用のポート | 3000 |
建築
この MCP サーバー:
- 個人アクセストークンを使用してFigma APIに接続します
- モデルコンテキストプロトコルに準拠した標準化されたインターフェースを公開します
- LLM が Figma デザインを操作するために使用できるツール、リソース、プロンプトを提供します。
- stdio トランスポート (ローカル接続) と SSE トランスポート (リモート接続) の両方をサポートします。
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。