Figma REST API

🚀 Figma モデルコンテキストプロトコル (MCP) サーバー

Figma MCP サーバーは、Figma とのインタラクションを可能にするツールで、Claude との統合もサポートしています。以下に、核心的な実装と機能の概要を示します。

• 核心的な実装：Figma との深い統合をサポートし、強力なデザインコラボレーション機能を提供します。
• Claude デスクトップ統合：Claude デスクトップ版とのシームレスな接続を実現します。
• ツール検証：すべてのツール入力は厳密に検証されます。
• エラー処理：詳細なエラー情報とステータスコードを提供します。

🚀 クイックスタート

プロジェクトの状態

完了した機能

1. 核心的な実装
   • MCP サーバーを初期化して起動します。
   • Figma とのデータ交換をサポートします。
   • Claude デスクトップ版を統合します。
   • 包括的なエラー処理メカニズムを提供します。
2. 潜在的な機能
   • チームレベルの権限管理を実装します。
   • OAuth 認証をサポートします。
   • より多くのデザインコラボレーションツールを開発します。

機能特性

核心機能

• セキュリティ認証：個人アクセストークンのみをサポートし、将来的には OAuth の実装を予定しています。
• レート制限：Figma API のレート制限規範に準拠しています。
• キャッシュ管理：デフォルトのキャッシュ TTL は 5 分で、最大キャッシュエントリ数は 500 です。
• モジュール解析：ローカルおよびグローバルモジュールの解像度をサポートしています。

ツール検証

すべてのツール入力は Zod を使用して厳密に検証されます。

const CreateVariablesSchema = z.object({
  fileKey: z.string(),
  variables: z.array(z.object({
    name: z.string(),
    type: z.enum(['COLOR', 'FLOAT', 'STRING']),
    value: z.string(),
    scope: z.enum(['LOCAL', 'ALL_FRAMES'])
  }))
});

📦 インストール

インストール手順

1. リポジトリをクローンする：Git を使用してプロジェクトをクローンします。
2. プロジェクトをビルドする：npm run build を実行して TypeScript ファイルをビルドします。
3. 環境変数を設定する：必要な環境変数を構成します。
4. サーバーを起動する：node dist/index.js を実行して MCP サーバーを起動します。

設定例

# 依存関係をインストールする
npm install

# プロジェクトをコンパイルする
npm run build

# サーバーを起動する
node dist/index.js --port 3000 --env development

💻 使用例

核心 API

• MCP サーバーを起動する

const server = await startMCPServer({
  port: 3000,
  env: 'development',
  debug: true
});

ツール検証スキーム

すべてのツールは Zod を使用して入力を検証し、データの正確性を確保します。

🔧 技術詳細

エラー処理

一般的なエラーコード

• 403 Forbidden：認証に失敗したか、無効なトークンです。
• 429 Too Many Requests：レート制限を超えました。
• 400 Bad Request：パラメータの検証に失敗しました。
• 500 Internal Server Error：サーバー内部エラーです。

既知の問題と制限

API 制限

1. 読み取り専用操作：現在のバージョンは読み取り操作のみをサポートしています。
2. トークン権限：個人アクセストークンには書き込み権限がありません。
3. キャッシュポリシー：デフォルトのキャッシュ TTL は 5 分で、容量上限は 500 項目です。

貢献ガイド

1. リポジトリをフォークする：自分のコードベースのコピーを作成します。
2. 機能ブランチを作成する：新しい機能や修正のために独立したブランチを作成します。
3. 変更をコミットする：詳細なテストケースを含めるようにします。
4. プルリクエストを送信する：メインブランチにマージします。

開発規範

• TypeScript の厳格モードに従います。
• ESLint を使用してコードをチェックします。
• Jest を使用して単体テストを行います。
• 包括的なエラー処理メカニズムを実装します。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しており、詳細は LICENSE ファイルを参照してください。

トラブルシューティング

詳細なデバッグ手順と解決策については、トラブルシューティングガイド を参照してください。

一般的な質問

1. JSON 接続エラー
   • Claude デスクトップ設定で絶対パスを使用することを確認してください。
   • サーバーが正常にビルドされたことを確認してください (dist/index.js)。
   • すべての環境変数が正しく設定されていることを検証してください。
2. 認証失敗
   • トークンが有効で期限切れでないことを確認してください。
   • トークンに必要な権限があることを確認してください。

連絡先

フィードバックや技術サポートが必要な場合は、プロジェクトのメンテナに連絡してください。