Figma MCP Server

Figma MCP サーバー

Figma REST API を完全にカバーするローカル MCP サーバーです。Claude Desktop、Cursor、VS Code、Gemini CLI、あらゆる MCP クライアントで動作します。npm および公式の MCP Registry で利用できます。

仕組み

各 Figma REST エンドポイントは、自己記述型の MCP ツールとして公開されます。起動時に tools/figma/ から自動検出されるため、エンドポイントの追加はファイルを追加するだけです。各呼び出しの前に必須パラメーターが検証されます。stdio 経由で動作します。

前提条件

Bun ≥ 1.2 が必要です。Bun ネイティブのため、npx ではなく bunx で起動してください（Node はサポートされていません）。

Figma API キー

Figma の「設定」>「セキュリティ」>「個人アクセストークン」>「新しいトークンを生成」から、個人アクセストークンを作成します。FIGMA_API_KEY として指定してください。クライアント設定の env ブロックに設定するのがおすすめです（以下を参照）。

クライアントを設定する

どのクライアントでも同じサーバーを使用します。command に bunx、またはクライアントが PATH から見つけられない場合は、その絶対パス（which bunx）を指定してください。

{
  "mcpServers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "your_figma_api_key_here"
      }
    }
  }
}

設定ファイルの場所：

• Claude Desktop：「設定」>「開発者」>「設定を編集」（claude_desktop_config.json）
• Cursor：~/.cursor/mcp.json、またはプロジェクトごとの .cursor/mcp.json
• Gemini CLI：~/.gemini/settings.json

設定を編集した後、クライアントを再起動してください。

VS Code

ワークスペースの .vscode/mcp.json またはユーザーの mcp.json を使用し、servers キーを設定します。トークンをハードコードする代わりに、入力を定義して VS Code から安全に入力できるようにします。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "figma-api-key",
      "description": "Figma API Key",
      "password": true
    }
  ],
  "servers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "${input:figma-api-key}"
      }
    }
  }
}

• ${input:figma-api-key} を指定すると、サーバーの初回起動時に VS Code がキーの入力を求め、安全な OS のシークレットストレージに保存します。
• 再入力または消去するには：「コマンド パレット」→ MCP: サーバー一覧 → サーバーを選択 → 入力をリセット／編集します。

ツールの対応範囲

Figma REST API（非推奨のエンドポイントを除く）を完全にカバーしており、次の分野にわたる 50 個のツールを利用できます。

• ファイルとノード（ファイル、ノードツリー、画像のレンダリング、画像の塗りつぶし、メタデータ、バージョン履歴）
• 変数／デザイントークン（読み取り、公開済み、一括変更）
• コンポーネント、コンポーネントセット、スタイル（ファイル、公開済み、チームの各スコープ）
• コメントとリアクション
• フォルダー（トップレベルのフォルダー、サブフォルダー、ファイル、メタデータ）
• ユーザー
• 開発リソース
• Webhook（v2）
• ライブラリアナリティクス（コンポーネント、スタイル、変数のアクションと使用状況）
• 組織：アクティビティログ、開発者ログ、AI の使用状況（Enterprise）
• 埋め込みと支払い

MCP クライアントのツール一覧で、常に最新のすべてのツール名とパラメーターを確認してください。

プランの要件

ほとんどのツールは、どのプランの個人アクセストークンでも利用できます。次のツールには上位プランが必要です。

• 変数（list_file_variables、get_published_variables、modify_variables）：Enterprise 組織。
• ライブラリアナリティクス（get_library_*）：Organization または Enterprise プラン。
• アクティビティログ、開発者ログ、AI の使用状況：管理者またはプランのアクセストークンを持つ Enterprise 組織。

---

MIT ライセンス · @planetabhi 作 ⋛⋋( ⊙◊⊙)⋌⋚