Designport

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 3, 2026

Figma REST API 客户端：文件、节点、图像、样式、组件、项目和评论。

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Figma REST API client: files, nodes, images, styles, components, projects and comments.

已验证STDIO仅桌面媒体与设计

概览

Designport 的本地 MCP 服务；无需登录；STDIO。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Designport，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

designport

designport is a compatible client for the Figma REST API, packaged as an MCP server and a small CLI. It is an independent client for the same public upstream API (https://api.figma.com/v1) — it is not a copy of Figma's hosted OAuth remote MCP server, and none of that server's OAuth tool surface (design context, screenshots, metadata, variable definitions, code-connect, FigJam, or design-system rules) is reproduced here.

The subset covers reading design files: fetch a file or specific nodes, render nodes to images, list image fills, styles, and components, browse team projects and project files, and read or post comments on a file.

Authentication is a Figma personal access token, sent as the X-Figma-Token header. Set FIGMA_PERSONAL_ACCESS_TOKEN before starting the server; a call made without it fails with an error naming the variable. The API base can be overridden with FIGMA_API_BASE.

Install

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

CLI

bash
designport get_file <file_key> --depth 2designport get_file_nodes <file_key> 1:2,3:4designport get_images <file_key> 1:2 --format png --scale 2designport 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

Exit codes: 0 success, 1 API error, 2 usage error.

MCP server

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

Tools

ToolInputFigma endpoint
get_filefile_key, version?, depth?GET /files/{key}
get_file_nodesfile_key, node_ids, depth?, version?GET /files/{key}/nodes
get_imagesfile_key, node_ids, format?, scale?GET /images/{key}
get_image_fillsfile_keyGET /files/{key}/images
get_file_stylesfile_keyGET /files/{key}/styles
get_file_componentsfile_keyGET /files/{key}/components
get_team_projectsteam_idGET /teams/{id}/projects
list_project_filesproject_idGET /projects/{id}/files
get_commentsfile_keyGET /files/{key}/comments
post_commentfile_key, message, client_meta?POST /files/{key}/comments

node_ids is a comma-separated string of node IDs, sent as the API's ids parameter. post_comment's optional client_meta is a string containing a JSON-encoded object — for example '{"x":10,"y":20}' — which is parsed and sent as the API's client_meta object; keeping it a string keeps the tool schema simple.

Out of scope for this subset: the variables API, dev resources, library assets and search, webhooks, activity logs, and payments.

Development

bash
npm installnpm run buildnpm test

Tests run entirely on fake-fetch fixtures; no network and no real token are used.

License

MIT — see LICENSE.

来源：README.md，提交 25cea81

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Nov 3, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分