Figma Local Context MCP

一个本地 .fig 文件 MCP Server。它结合了当前项目里的 .fig 解码、节点 SVG/PNG 导出能力，以及 GLips/Figma-Context-MCP 的 MCP 工具注册方式。

这个项目不依赖 Figma REST API，也不需要 FIGMA_API_KEY。MCP 客户端只需要传入本机 .fig 或 .fig.json 路径即可。

工具

• get_design_context：官方 Figma MCP 风格的主入口，返回节点树、样式、tokens 和代码提示。
• get_code_context：返回更适合代码生成的布局、样式和导出资源提示。
• export_assets：批量导出多个节点为 SVG 或 PNG。
• list_fig_nodes：按名称、类型或 node-id 搜索节点。
• get_design_tokens：从全文件或指定节点子树中推导颜色、渐变、阴影、描边 token。
• inspect_fig_file：读取本地 .fig，返回节点数量、类型统计和节点概览。
• get_fig_node：按节点名、2625:12945、2625-12945、node-id=2625-12945 或完整 Figma 链接查找节点，并返回简化上下文。
• export_fig_node：把指定节点导出为 SVG 或 PNG，PNG 支持倍率。

示例参数

获取官方风格设计上下文：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQuery": "node-id=2625-12945",
  "depth": 2,
  "includeTokens": true,
  "includeCodeHints": true
}

获取代码生成上下文：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQuery": "2625-12945",
  "depth": 2
}

搜索节点：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "query": "Group 1321315187",
  "limit": 20
}

批量导出资源：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQueries": ["2625-12945", "Group 1321315187"],
  "outputDir": "D:\\MyFiles\\Download\\fig-export-debug\\assets",
  "format": "png",
  "scale": 2
}

获取设计 token：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQuery": "2625-12945"
}

底层文件概览：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "maxNodes": 20
}

底层单节点查询：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQuery": "node-id=2625-12945",
  "depth": 1
}

底层单节点导出：

{
  "filePath": "D:\\MyFiles\\Download\\兴泰安全生产预计平台-朱梓鑫.fig",
  "nodeQuery": "2625-12945",
  "outputPath": "D:\\MyFiles\\Download\\fig-export-debug\\mcp-export-node.png",
  "format": "png",
  "scale": 2
}

开发

pnpm install
pnpm typecheck
pnpm build

本地调试：

pnpm dev

MCP 客户端配置示例：

{
  "mcpServers": {
    "Figma Local Context": {
      "command": "cmd",
      "args": ["/c", "pnpm", "--dir", "D:\\MyFiles\\Codes\\Node\\figma-local-context-mcp", "dev"]
    }
  }
}

构建后也可以使用：

{
  "mcpServers": {
    "Figma Local Context": {
      "command": "cmd",
      "args": ["/c", "node", "D:\\MyFiles\\Codes\\Node\\figma-local-context-mcp\\dist\\bin.js", "--stdio"]
    }
  }
}

引用与致谢

本项目在实现过程中参考并复用了以下开源项目的思路或能力：

• GLips/Figma-Context-MCP：参考它的 MCP Server 组织方式、工具注册结构和官方 Figma MCP 风格的上下文输出思路。该仓库根目录提供 MIT License，package.json 也声明为 MIT。
• yagudaev/figma-to-json：参考它对 .fig 文件读写和解码的实现方向，并在本项目中继续扩展本地节点检索、SVG/PNG 导出和 MCP 上下文能力。该仓库根 package.json 声明 license: MIT；当前主分支没有单独的根 LICENSE 文件。

许可证兼容性

上面两个引用仓库均声明为 MIT 许可证。MIT 许可证允许使用、复制、修改、合并、发布、分发、再许可和销售软件副本，因此支持本项目的私有使用、商业使用、二次开发和发布。需要遵守的核心条件是：分发包含这些项目的代码或其重要部分时，应保留对应的版权声明和许可声明。

本项目同样使用 MIT License，见 LICENSE。