Image Prep MCP

MCP设计创作

提供方 Blurjp

设计创作 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个将Figma设计转换为Claude可读图像的服务,支持自动分片、压缩和智能裁剪,适用于多用户协作的设计处理场景。

一句话选型结论

按资料字段整理

Image Prep MCP 属于设计创作类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类设计创作 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 10 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

设计创作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

设计转换Python本地部署智能裁剪多租户图像处理Figma集成

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run -d -p 6379:6379 redis

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
出图与素材

生成配图、图标与素材。

设计稿处理

读取设计稿、批量改尺寸或导出。

内容生成

按主题生成文案与视觉草稿。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在设计创作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Image Prep MCP当前 6 stdio · 本地进程 本地部署 有 2026-05-17
Cursor Talk To Figma MCP Da1c7911 40 未标注 未标注 无 2026-05-17
Blender MCP 17 stdio · 本地进程 本地部署 有 2026-05-18
Nova Canvas MCP Server 2 stdio · 本地进程 本地部署 有 2026-05-17
Figma Context MCP 3aaa8d28 未标注 未标注 支持远程部署 无 2026-05-17
kreuzberg 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

设计创作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Blurjp上游标注的维护方 Blurjp
分类设计创作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

Figma智能图像MCP服务器

一种模型上下文协议(MCP)服务器,通过自动平铺、压缩和智能裁剪将Figma设计处理成克劳德可读的图像。

注意:服务器的规范源代码位于 figma-smart-image-mcp/。根目录仅包含文档和部署帮助程序。

实时部署

公共URL: https://figma-smart-image-mcp-production.up.railway.app/

实时部署支持 多租户身份验证 -多个用户可以同时使用自己的Figma令牌。

特性

  • 智能导出:从Figma自动导出SVG/PNG
  • 自动平铺:大型设计自动拆分为可管理的图块
  • 压缩:针对Claude的上下文大小限制进行了优化
  • 智能作物:启发式检测UI模式以获得更好的作物
  • 多住户:每个用户都使用自己的Figma令牌进行身份验证
  • Redis支持:跨会话的可靠令牌存储

快速入门(使用实时部署)

选项A:快速命令(建议大多数用户使用)

在终端中运行以下命令:```bash
claude mcp add --transport http figma-smart-image https://figma-smart-image-mcp-production.up.railway.app/mcp


就是这样!现在跳到 **步骤2** 在......下面

### 选项B:手动配置(.clauderc文件)

创建或更新 `.clauderc` 在您的项目目录中:```json
{
"mcpServers": {
"figma-smart-image": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sse",
"https://figma-smart-image-mcp-production.up.railway.app/mcp"
]
}
}
}

第二步:使用Figma进行身份验证(推荐)

首次使用MCP服务器时,请单击 验证 在克劳德。服务器将
自动启动Figma OAuth,完成后返回给Claude。
如果克劳德稍后出现 身份验证:未通过身份验证,只需单击 验证 再次重新授权。

步骤3:(可选)手动输入令牌

如果您更喜欢个人访问令牌:

  1. 从获取令牌 Figma设置
  2. 打开 https://figma-smart-image-mcp-production.up.railway.app/
  3. 输入您的令牌并单击“连接到Figma”

第四步:开始使用Claude

现在,您可以在Claude中使用Figma Smart Image工具:```typescript
// Ask Claude to process a Figma design
"Please extract the hero section from this Figma link:
https://www.figma.com/design/..."


## 运作原理```
┌─────────────────┐
│  Claude Client  │
└────────┬────────┘
│ 1. Request MCP connection
▼
┌─────────────────────────────┐
│  Railway Deployment         │
│  (Multi-Tenant Server)      │
└────────┬────────────────────┘
│ 2. Returns device_code + user_code
▼
┌─────────────────────────────┐
│  User visits auth page      │
│  - Enters user_code         │
│  - Enters Figma token       │
└────────┬────────────────────┘
│ 3. Token stored in Redis
▼
┌─────────────────────────────┐
│  Client polls for token     │
│  - Gets access_token        │
│  - Uses Bearer auth         │
└────────┬────────────────────┘
│ 4. Ready to use tools!
▼
┌─────────────────────────────┐
│  Figma Smart Image Tools    │
│  - process_figma_link       │
│  - get_figma_components     │
│  - get_figma_node_details   │
│  - get_figma_variables      │
│  - list_figma_frames        │
└─────────────────────────────┘

可用工具

process_figma_link

处理Figma URL并将图像+图块导出到磁盘。

输入:```json
{
"url": "https://www.figma.com/design/...",
"out_dir": "/path/to/output",
"prefer_format": "webp"
}


### `get_figma_components`

列出Figma文件中的所有组件和组件集。

**输入:**```json
{
"url": "https://www.figma.com/design/..."
}

get_figma_node_details

返回特定节点的布局和样式详细信息。

输入:```json
{
"url": "https://www.figma.com/design/...?...&node-id=1-123"
}


### `get_figma_variables`

返回设计变量(需要Figma Pro计划或更高版本)。

**输入:**```json
{
"url": "https://www.figma.com/design/..."
}

list_figma_frames

使用浅取列出顶级框架/组件。

输入:```json
{
"url": "https://www.figma.com/design/...",
"max_frames": 200
}


### `debug_figma_access`

显示令牌属于哪个Figma用户以及文件是否可访问。

**输入:**```json
{
"url": "https://www.figma.com/design/..."
}

身份验证流程(技术细节)

OAuth授权码+PKCE(克劳德桌面版)

Claude Desktop使用authorization_code+PKC流程。如果还没有可用的令牌,
服务器将直接重定向到Figma OAuth并自动恢复。

OAuth设备代码流(传统CLI)

服务器使用OAuth 2.0设备授权授予:

  1. 设备授权请求```bash
    POST /device/authorize
    Content-Type: application/json

{
"client_id": "mcp_client"
}

Response:
{
"device_code": "device_xxx",
"user_code": "ABC123",
"verification_uri": "https://...",
"expires_in": 600
}


2. **用户认证**```bash
POST /auth
Content-Type: application/x-www-form-urlencoded

user_code=ABC123&token=figd_xxx
  1. 令牌轮询```bash
    POST /oauth/token
    Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:device_code&device_code=device_xxx

Response:
{
"access_token": "device_xxx",
"token_type": "Bearer",
"expires_in": 3600
}


4. **经过身份验证的请求**```bash
POST /message?sessionId=xxx
Authorization: Bearer device_xxx
Content-Type: application/json

{
"jsonrpc": "2.0",
"method": "tools/call",
"params": { ... }
}

超时

  • MCP_TOOL_TIMEOUT_MS / FIGMA_TOOL_TIMEOUT_MS (默认值: 60000)控制总工具执行时间。
  • FIGMA_REQUEST_TIMEOUT_MS 控制单个Figma API+图像下载请求。

推荐:对于大型Figma文件,将两者都设置为 120000 (120秒)以避免超时。

故障排除

无效令牌/403来自Figma

如果工具返回 Invalid token 或 403:

  1. 清除缓存的OAuth令牌:```bash
    curl -s "https://figma-smart-image-mcp-production.up.railway.app/health?debug=clear_oauth"
1. 重新运行 **验证** 在克劳德。
1. 通过以下方式进行验证:```
debug_figma_access
{"url":"https://www.figma.com/design/..."}

节点id格式问题

Figma URL通常对节点ID进行不同的编码或格式化。服务器会对这些进行标准化,但你
也可以使用以下形式之一:

  • node-id=1:1234
  • node-id=1-1234
  • node-id=1%3A1234 (URL编码)

如果你看到 No image URL returned for node ...,尝试标准化 node-id 或使用:```
list_figma_frames
{"url":"https://www.figma.com/design/..."}


## 本地开发

要在本地运行:```bash
# Install dependencies
npm install

# Set your Figma token (optional - multi-tenant mode works without it)
export FIGMA_TOKEN="your_figma_token_here"

# Build
npm run build

# Run server
npm start

对于Redis的本地开发:```bash

Using Docker

docker run -d -p 6379:6379 redis

Set Redis URL

export REDIS_URL="redis://localhost:6379"
```

配置

环境变量:

变量 描述 默认值
FIGMA_TOKEN Figma个人访问令牌(多租户可选) -
REDIS_URL 多租户令牌存储的Redis连接URL -
PORT HTTP服务器端口 3845

建筑

  • 运输:带有服务器发送事件(SSE)的HTTP
  • 存储:Redis用于设备代码和会话令牌
  • 认证:OAuth 2.0设备授权授予
  • 部署:铁路(Docker容器)

安全

  • 每个用户的Figma令牌在Redis中是隔离的
  • 代币在1小时后过期
  • 设备代码在10分钟后过期
  • 所有MCP请求都需要承载令牌

许可证

麻省理工学院

支持

有关问题和疑问,请使用GitHub问题页面。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Image Prep MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -d -p 6379:6379 redis。装完在客户端配置里引用同一个包或端点。

Image Prep MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Image Prep MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Image Prep MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Image Prep MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Image Prep MCP 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 多租户、Python、Claude、图像处理。具体工具清单以官方文档为准。

Image Prep MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Image Prep MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。