designport

designport

designportは、MCP サーバーと小規模なCLIとしてパッケージ化された、Figma REST API互換のクライアントです。同じ公開アップストリームAPI（https://api.figma.com/v1）向けの独立したクライアントであり、FigmaがホストするOAuthリモートMCPサーバーの複製ではありません。また、そのサーバーが提供するOAuthツール群（デザインコンテキスト、スクリーンショット、メタデータ、変数定義、code-connect、FigJam、デザインシステムのルール）も再現していません。

このサブセットでは、デザインファイルの読み取りに対応しています。ファイルまたは特定のノードの取得、ノードの画像へのレンダリング、画像塗りつぶし・スタイル・コンポーネントの一覧表示、チームのプロジェクトやプロジェクトファイルの参照、ファイルのコメントの読み取りや投稿ができます。

認証にはFigmaの個人用アクセストークンを使用し、X-Figma-Tokenヘッダーで送信します。サーバーを起動する前にFIGMA_PERSONAL_ACCESS_TOKENを設定してください。設定されていない状態で呼び出すと、この変数名を示すエラーが発生します。APIベースURLはFIGMA_API_BASEで上書きできます。

インストール

npx @reneturcios/designport get_file <file_key>
docker run -i ghcr.io/cloudcorprecords/designport

CLI

designport get_file <file_key> --depth 2
designport get_file_nodes <file_key> 1:2,3:4
designport get_images <file_key> 1:2 --format png --scale 2
designport get_file_styles <file_key>
designport get_team_projects <team_id>
designport list_project_files <project_id>
designport post_comment <file_key> "Looks good"
designport --version

終了コード：成功は0、APIエラーは1、使用方法のエラーは2です。

MCP サーバー

npx -y @reneturcios/designport mcp

{
  "mcpServers": {
    "designport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/designport", "mcp"],
      "env": { "FIGMA_PERSONAL_ACCESS_TOKEN": "your-token" }
    }
  }
}

ツール

ツール	入力	Figmaエンドポイント
get_file	file_key、version?、depth?	GET /files/{key}
get_file_nodes	file_key、node_ids、depth?、version?	GET /files/{key}/nodes
get_images	file_key、node_ids、format?、scale?	GET /images/{key}
get_image_fills	file_key	GET /files/{key}/images
get_file_styles	file_key	GET /files/{key}/styles
get_file_components	file_key	GET /files/{key}/components
get_team_projects	team_id	GET /teams/{id}/projects
list_project_files	project_id	GET /projects/{id}/files
get_comments	file_key	GET /files/{key}/comments
post_comment	file_key、message、client_meta?	POST /files/{key}/comments

node_idsは、APIのidsパラメーターとして送信される、ノードIDをカンマで区切った文字列です。post_commentの省略可能なclient_metaは、JSONエンコードされたオブジェクトを含む文字列です。たとえば'{"x":10,"y":20}'のように指定します。これは解析され、APIのclient_metaオブジェクトとして送信されます。文字列にすることで、ツールのスキーマをシンプルに保てます。

このサブセットの対象外：変数API、開発リソース、ライブラリアセットと検索、Webhook、アクティビティログ、決済機能。

開発

npm install
npm run build
npm test

テストはすべてfake-fetchフィクスチャ上で実行されます。ネットワークも実際のトークンも使用しません。

ライセンス

MIT — LICENSEを参照してください。