@empjs/nova-d2c-mcp

Nova D2C 的 MCP 服务器，用于在 Cursor、VSCode 等编辑器中对接 Figma 设计稿。

安装

npm install -g @empjs/nova-d2c-mcp
# 或
pnpm add -g @empjs/nova-d2c-mcp
# 或
bun add -g @empjs/nova-d2c-mcp

使用

1. 在 Figma 中打开 Nova D2C Chrome 扩展，开启 MCP 服务器
2. 在编辑器中运行：

npx -y @empjs/nova-d2c-mcp@latest

3. 在 Cursor/VSCode 中配置 MCP 服务器（参考扩展内的「安装」引导）

环境变量

• NOVA_D2C_MCP_RUNTIME_DIR - 运行时目录
• NOVA_D2C_MCP_LOG_DIR - 日志目录
• NOVA_D2C_MCP_ASSET_DIR - 资源存储目录
• NOVA_D2C_MCP_TOOL_TIMEOUT - 工具调用超时（毫秒）
• NOVA_D2C_MCP_ASSET_TTL_MS - 资源 TTL（毫秒，0 表示禁用）

工具

• get_figma_data - 获取 Figma 文件数据（布局、内容、样式、组件信息）
• download_figma_images - 下载 Figma 文件中的 SVG/PNG 图片
• get_assets - 解析资源 hash 为可下载的 URL（Hub 端，内部使用）

测试客户端

提供了测试客户端用于验证完整的 MCP 链路（Client → CLI → Hub → Extension → Figma）。

前提条件：

1. Hub 已在运行（MCP Server 已启动）
2. Chrome Extension 已连接 Figma 并开启 MCP

使用方式：

# 仅查看可用工具列表
bun run test:client -- --listOnly

# 获取 Figma 数据（fileKey 来自 figma.com/design/<fileKey>/...）
bun run test:client -- --fileKey <fileKey>

# 指定节点和遍历深度
bun run test:client -- --fileKey <fileKey> --nodeId 123:456 --depth 2

# 指定调用其他工具
bun run test:client -- --fileKey <fileKey> --tool download_figma_images

直接用 bun 运行：

bun run test/client.ts --fileKey <fileKey>
bun run test/client.ts --fileKey <fileKey> --nodeId 123:456 --depth 2