为什么值得关注

它提供了一种结构化的、由代理驱动的工作流程来检索和物化科学图表，可与任何 stdio MCP 主机配合使用（不仅限于 Wisp），并在提交前内置视觉审核步骤以确保模板相关性。

适合谁使用

需要快速查找和复用科学图表模板的研究人员
构建集成图表检索功能的 MCP 主机的开发者
寻求可重现绘图代码和布局的数据科学家

典型使用场景

从 FigureYa 库中搜索并导入火山图模板
将用户现有的图表和代码添加到本地库中以便后续复用
将选定的模板物化到项目目录中进行改编

项目优势

可与任何 stdio MCP 主机配合使用，不局限于 Wisp
安全契约：绝不执行绘图代码或依赖安装程序，通过 SHA-256 验证文件完整性
代理驱动的工作流：分析输入、搜索、预览、视觉审核，然后仅物化被接受的模板
独立的 FigureYa 源包支持离线分发大型存档（约 3 GiB），不会使核心插件臃肿

使用前须知

物化错误是终结性的——代理必须报告失败并等待，不允许回退或替代
需要 Node.js 22 或更高版本来构建和运行
FigureYa 内容采用 CC BY-NC-SA 4.0 许可证，可能限制这些模板的商业用途

README 快速开始

Scientific Figure Library

Scientific Figure Library is a standard MCP server and MCP App for finding, importing, and materializing scientific figure references. It is not tied to Wisp: any stdio MCP host can use it. The included Wisp manifest and Skill are a thin optional adapter.

The first release has two template sources:

FigureYa — 319 searchable modules with local thumbnails and commit-pinned archives.
User Library — figures and plotting code copied from paths supplied by the MCP host.

The host Agent analyzes an uploaded image, a natural-language request, or a data file. It builds a compact retrieval intent, searches both sources, inspects the top preview, and decides whether that candidate actually matches before materializing anything. The catalog score orders retrieval candidates; it is not a recommendation or visual-similarity score.

For image input, the Agent must first inspect the user's image with the host's view_image, then inspect the top candidate with figure_library_preview. The final recommendation includes an Agent-produced visual pass/reject score covering chart family, layout, axes/geometry, encodings, and annotations/style, plus a separate data-compatibility verdict.

Safety contract

The server copies and extracts reference files but never executes plotting code or dependency installers. It verifies imported user files with SHA-256 and verifies FigureYa archives against the pinned catalog.

Materialization errors are terminal. figure_library_materialize returns a STOP: error that instructs the Agent to report the exact failure and wait for the user. The Agent must not switch extraction modes, use another downloader, fetch the complete repository, recreate the template, or generate a substitute/demo plot. This behavior is covered by the MCP smoke test.

Build

Requirements: Node.js 22 or newer.

npm install
npm run check

Use with any stdio MCP client

{
  "mcpServers": {
    "figure-library": {
      "command": "node",
      "args": ["/absolute/path/to/ScientificFigureLibrary/dist/index.js"],
      "env": {
        "FIGURE_LIBRARY_DIR": "/absolute/path/to/my-figure-library",
        "FIGUREYA_SOURCE_PACK_DIR": "/optional/path/to/FigureYaSourcePack"
      }
    }
  }
}

FIGURE_LIBRARY_DIR defaults to ~/.figure-library. The server exposes:

figure_library_open — op

项目描述

Standard MCP server and MCP App for scientific figure templates from FigureYa and user-supplied references

ScientificFigureLibrary