figma-custom-mcp

3つの特定の、確認された機能ギャップを修正する小さなMCP + Figmaプラグインです。Plumb を修正、フォーク、または置き換えるものではなく、Figma内でPlumbと並べて使用するように設計されています。

ギャップとその完全なソースレベルの証拠は、PLUMB_GAP_ANALYSIS.md（Plumb v0.13.2のソースからの監査）に文書化されています。このプロジェクトは、その監査のP0項目を正確に実装しています：

• P0-1 — 絶対配置/重なり配置。 PlumbのDSLコンパイラはすべてのコンテナを自動レイアウトに強制し、FigmaのlayoutPositioning="ABSOLUTE"を決して設定しないため、重なり合う構成（画像の上のバッジ、写真の上のテキストなど）を構造的に構築することが不可能です。このプロジェクトのコンパイラはデフォルトで自由（x/y）配置を使用し、自動レイアウト領域内でabsolute: trueの子要素をサポートします。

• P0-2 — ローカル/カスタム画像のインポート。 Plumbのimage.srcは常に6つの固定ストックフォトプロバイダに対するウェブ検索クエリにコンパイルされます。ユーザー自身のファイルがPlumbで構築されたデザインに入ることは決してありません。このプロジェクトはfile:/data: URIを直接読み取り、型付きエラーとプレースホルダーの置換なしで処理します。

• P0-3 — 厳格なスキーマ検証。 PlumbのZodスキーマは未知のフィールドやスペルミスのフィールドを黙って削除します。ここでのすべてのスキーマは.strict()です。

完全な監査項目ごとのトレーサビリティについてはdocs/P0-CAPABILITY-MATRIX.mdを、残りのドキュメントセットについてはdocs/を参照してください。

Status

P0完了 — 完全な受入基準チェックリスト、実際のライブFigmaテスト結果、およびこのプロジェクトが構築した実際の構成（実際の重なり合うFigmaノード、実際のローカル画像、実際の回転/グラデーション/エフェクト — フラット化された画像ではありません）のスクリーンショットについては、P0-FINAL-REPORT.mdを参照してください。

Related MCP server: Figma Bridge MCP

Quickstart

npm install
npm run build
npm test

次に、docs/QUICKSTART.mdを参照して、Figmaプラグインをペアリングし、ライブのエンドツーエンドテストを実行してください。

Documentation

• docs/ARCHITECTURE.md

• docs/P0-CAPABILITY-MATRIX.md

• docs/P0-TOOLS.md

• docs/P0-DESIGN-SCHEMA.md

• docs/P0-TEST-PLAN.md

• docs/P0-IMPLEMENTATION.md

• docs/P0-LIMITATIONS.md

• docs/QUICKSTART.md

License

MIT