Skip to content
Back to search

figure-library

Search Local Published, FigureYa, bundled Open Figure Modules, frozen explicit-only Community, and explicitly trusted dynamic Providers; materialize exact immutable figure references without executing module code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 14 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/xuzhougeng/ScientificFigureLibrary with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/xuzhougeng/ScientificFigureLibrary'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xuzhougeng--scientificfigurelibrary/badge.svg)](/listings/xuzhougeng--scientificfigurelibrary)

HTML

<a href="/listings/xuzhougeng--scientificfigurelibrary"><img src="/api/listings/xuzhougeng--scientificfigurelibrary/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Node.js 22+ is required. Do not execute user plotting code. After install, bind one global Library directory on disk; if `setup_required`, also bind a Local workspace before searching.

Pi

Install the published npm package. Do not `pi install` a GitHub URL or git clone: the repository does not contain `dist/`, so MCP cannot start.

pi install npm:pi-mcp-adapter
pi install npm:scientific-figure-library

Restart Pi. The package loads the `figure-library` Skill and registers the stdio MCP server through pi-mcp-adapter. If you already copied a local SFL app MCP config into `~/.config/mcp/mcp.json` or `.mcp.json`, skip `pi install npm:scientific-figure-library` — that duplicates tools.

Paste this request:

Install Scientific Figure Library for Pi.
Run: pi install npm:pi-mcp-adapter
Then: pi install npm:scientific-figure-library
Restart Pi. Do not clone the GitHub repo and do not add a second
figure-library MCP entry. First test: figure_library_get_skill, then
figure_library_source_status. If setup_required, bind the global Library
and Local workspace. Tell me when I need to restart Pi.

DeepSeek Harness (dsh)

`--profile` is required. Use `web` unless you run another profile.

dsh plugin --profile web add scientific-figure-library

Restart the profile (`dsh --profile web` or `dsh web`). The bundle registers the Skill and mounts `@deepseek-ai/dsh-mcp-client` against this package. If you already added a dsh MCP client row for a local SFL app, do not also run `dsh plugin add scientific-figure-library`.

Paste this request:

Install Scientific Figure Library for DeepSeek Harness.
Run: dsh plugin --profile web add scientific-figure-library
Restart the web profile. Do not clone the GitHub repo and do not add a
second figure-library MCP row. First test: figure_library_get_skill, then
figure_library_source_status. If setup_required, bind the global Library
and Local workspace. Tell me when I need to restart dsh.

Claude, Codex, Cursor, Wisp, or another stdio host

Give the agent this repository and the following request:

Install Scientific Figure Library from
https://github.com/xuzhougeng/ScientificFigureLibrary.

Follow docs/QUICKSTART.md. Prefer a GitHub Release ZIP when one is published.
Node.js 22+ is required. Register the stdio MCP server as figure-library
pointing at dist/index.js. For Wisp Science, use npm run package:wisp and
install the generated plugin. For Cursor, use npm run package:cursor and unzip
into ~/.cursor/plugins/local/figure-library/. Bind one global Library directory on disk.
Do not execute user plotting code. First test: open or source_status; if
setup_required, bind the global Library and Local workspace before searching.
Tell me when I need to grant folder access or start a new host session.

Manual steps: [docs/QUICKSTART.md](docs/QUICKSTART.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 11 lines
  1. {
  2. "name": "figure-library",
  3. "version": "0.9.3",
  4. "description": "Search Local Published, FigureYa, bundled Open Figure Modules, frozen explicit-only Community, and explicitly trusted dynamic Providers; materialize exact immutable figure references without executing module code.",
  5. "author": {
  6. "name": "xuzhougeng and jarxunlai"
  7. },
  8. "mcpServers": "./.claude-plugin/mcp.json",
  9. "homepage": "https://xuzhougeng.github.io/ScientificFigureLibrary/",
  10. "repository": "https://github.com/xuzhougeng/ScientificFigureLibrary"
  11. }
README.md · README · 278 lines
  1. <p align="center">
  2. <img src=".github/assets/sfl-banner.svg" alt="Scientific Figure Library — local-first MCP App for your scientific figures on Claude Science and Wisp Science." width="100%" />
  3. </p>
  4. # Scientific Figure Library
  5. [Website](https://xuzhougeng.github.io/ScientificFigureLibrary/) ·
  6. [简体中文](README.zh-CN.md) ·
  7. [Quickstart](docs/QUICKSTART.md) ·
  8. [User Guide (online)](https://github.com/xuzhougeng/ScientificFigureLibrary/blob/main/docs/USER_GUIDE.md) ·
  9. [Protocol](docs/PROTOCOL.md) ·
  10. [Releases](https://github.com/xuzhougeng/ScientificFigureLibrary/releases) ·
  11. [Wisp Science](https://github.com/xuzhougeng/wisp-science)
  12. Scientific Figure Library (SFL) is a **local-first MCP server and MCP App** for
  13. **your scientific figures**. You import a figure and its code, review them,
  14. publish an immutable Release to **one global Library on your machine**, then
  15. reuse that exact template across projects in **Claude Science**, **Wisp Science**,
  16. **Codex**, **Cursor**, **Pi**, **dsh**, and other stdio MCP hosts.
  17. The Library stays on disk you choose. Nothing is copied into every project
  18. until you confirm a materialization. The server does **not** execute plotting
  19. code and does not contain a second model: the host agent inspects files; SFL
  20. hashes, versions, gates, and publishes them.
  21. The default retrieval order is **Local Published → FigureYa → Open Figure
  22. Modules → enabled dynamic personal Providers**. The bundled Community snapshot
  23. is retained for explicit compatibility, but is frozen and excluded from default
  24. search (`includeInDefaultSearch: false`). The source of truth for your own
  25. figures is always **Local Published**.
  26. A bundled extra catalog may currently contain zero releases after an authorized
  27. redaction; that is a healthy empty source, not a failure, and default search
  28. continues across other providers.
  29. <p align="center">
  30. <img src="docs/assets/sfl-gallery.png" alt="Scientific Figure Library MCP App: browse locally published scientific figure templates, then confirm one exact Release before materializing it." width="100%" />
  31. </p>
  32. <p align="center"><em>Search your local published library in the MCP App, confirm one exact template, then materialize it into a project.</em></p>
  33. ## Local client preview
  34. Separate native macOS Apple Silicon and Intel DMGs, a per-user Windows installer, plus Windows and Linux ZIPs with bundled Node, are available through the local-client release workflow. Both bundled-Node and `no-node` editions (requiring installed Node.js 22+) omit gallery images and download previews on demand. See [installation and preview limitations](docs/INSTALL_LOCAL.md). The macOS preview is ad-hoc signed and is not notarized.
  35. ## Install with a coding agent
  36. Node.js 22+ is required. Do not execute user plotting code. After install, bind
  37. one global Library directory on disk; if `setup_required`, also bind a Local
  38. workspace before searching.
  39. ### Pi
  40. Install the published npm package. Do not `pi install` a GitHub URL or git
  41. clone: the repository does not contain `dist/`, so MCP cannot start.
  42. ```bash
  43. pi install npm:pi-mcp-adapter
  44. pi install npm:scientific-figure-library
  45. ```
  46. Restart Pi. The package loads the `figure-library` Skill and registers the
  47. stdio MCP server through pi-mcp-adapter. If you already copied a local SFL app
  48. MCP config into `~/.config/mcp/mcp.json` or `.mcp.json`, skip
  49. `pi install npm:scientific-figure-library` — that duplicates tools.
  50. Paste this request:
  51. ```text
  52. Install Scientific Figure Library for Pi.
  53. Run: pi install npm:pi-mcp-adapter
  54. Then: pi install npm:scientific-figure-library
  55. Restart Pi. Do not clone the GitHub repo and do not add a second
  56. figure-library MCP entry. First test: figure_library_get_skill, then
  57. figure_library_source_status. If setup_required, bind the global Library
  58. and Local workspace. Tell me when I need to restart Pi.
  59. ```
  60. ### DeepSeek Harness (dsh)
  61. `--profile` is required. Use `web` unless you run another profile.
  62. ```bash
  63. dsh plugin --profile web add scientific-figure-library
  64. ```
  65. Restart the profile (`dsh --profile web` or `dsh web`). The bundle registers
  66. the Skill and mounts `@deepseek-ai/dsh-mcp-client` against this package. If you
  67. already added a dsh MCP client row for a local SFL app, do not also run
  68. `dsh plugin add scientific-figure-library`.
  69. Paste this request:
  70. ```text
  71. Install Scientific Figure Library for DeepSeek Harness.
  72. Run: dsh plugin --profile web add scientific-figure-library
  73. Restart the web profile. Do not clone the GitHub repo and do not add a
  74. second figure-library MCP row. First test: figure_library_get_skill, then
  75. figure_library_source_status. If setup_required, bind the global Library
  76. and Local workspace. Tell me when I need to restart dsh.
  77. ```
  78. ### Claude, Codex, Cursor, Wisp, or another stdio host
  79. Give the agent this repository and the following request:
  80. ```text
  81. Install Scientific Figure Library from
  82. https://github.com/xuzhougeng/ScientificFigureLibrary.
  83. Follow docs/QUICKSTART.md. Prefer a GitHub Release ZIP when one is published.
  84. Node.js 22+ is required. Register the stdio MCP server as figure-library
  85. pointing at dist/index.js. For Wisp Science, use npm run package:wisp and
  86. install the generated plugin. For Cursor, use npm run package:cursor and unzip
  87. into ~/.cursor/plugins/local/figure-library/. Bind one global Library directory on disk.
  88. Do not execute user plotting code. First test: open or source_status; if
  89. setup_required, bind the global Library and Local workspace before searching.
  90. Tell me when I need to grant folder access or start a new host session.
  91. ```
  92. Manual steps: [docs/QUICKSTART.md](docs/QUICKSTART.md).
  93. ## What is included
  94. - **Local Published library** — one user-selected directory, shared across
  95. projects and hosts
  96. - Direct **image + code intake**, review gates, immutable Revisions and Releases
  97. - MCP App gallery: browse, exact preview, user confirmation
  98. - Search, describe, preview, then **materialize** an exact confirmed template
  99. - Portable backup / restore / fork of the Library
  100. - Optional extra search providers; they do not replace local review
  101. - **Open Figure Modules** — the same `io.github.jarxunlai.personal-figures`
  102. Provider. A bundled snapshot is only the offline bootstrap. After install,
  103. SFL asynchronously checks a signed GitHub feed and atomically switches the
  104. local Catalog overlay. Ordinary template updates no longer require
  105. repackaging the plugin. Complete module ZIPs are still fetched only for one
  106. exact selected materialization.
  107. ## Bundled figure workflow
  108. The host plugin ZIPs and the npm package used by Pi and dsh include one core figure-library Skill with on-demand
  109. description, script-organization and style references. Ordinary MCP hosts can
  110. read the same guidance with `figure_library_get_skill`, browse thumbnails with
  111. `figure_library_get_candidate_images` or resource URIs, and paginate with
  112. `figure_library_search_page`. The MCP App is optional. Approved R/Python runtimes and host execution/image tools
  113. are still required when the user asks to draw.
  114. Template details render safe Markdown for the requirement, biological use
  115. cases and data profile, with actual input/code/package lists visible.
  116. Technical identities and validation state are available in a collapsed area.
  117. Historical Local Published/OFM entries remain readable; this update does not
  118. rewrite their content or the bundled FigureYa catalog.
  119. ## First success
  120. ```text
  121. Call figure_library_source_status. If writes are disabled, help me bind one
  122. absolute global Library directory (plan then apply after I confirm the path).
  123. Open the workbench and search my Local Published templates. Wait for me to
  124. confirm one card. Then plan materialization into an empty folder I specify.
  125. Do not execute R or Python. Do not redraw the figure.
  126. ```
  127. If the local library is empty, import a figure/code pair, review it, and
  128. publish a Release before searching. Full contract: [docs/PROTOCOL.md](docs/PROTOCOL.md).
  129. ## Develop from source
  130. Requires Node.js 22+:
  131. Pull requests run tests, type checking, build and MCP smoke across Linux, Windows
  132. and macOS. See [basic CI](docs/CI.md) for the matrix and merge-check setup.
  133. Pushing a stable `vX.Y.Z` tag packages local clients, host plugins, the npm
  134. tarball and the Wisp update feed, then uploads them to the GitHub Release.
  135. Maintainers can also configure the optional [AI comment bot](docs/COMMENT_BOT.md)
  136. for manually requested issue suggestions and PR reviews.
  137. ```bash
  138. git clone https://github.com/xuzhougeng/ScientificFigureLibrary.git
  139. cd ScientificFigureLibrary
  140. npm ci
  141. npm run check
  142. node dist/index.js
  143. ```
  144. ```json
  145. {
  146. "mcpServers": {
  147. "figure-library": {
  148. "command": "node",
  149. "args": ["/absolute/path/to/ScientificFigureLibrary/dist/index.js"]
  150. }
  151. }
  152. }
  153. ```
  154. The Library locator is machine-local (`locator.json` under AppData / XDG).
  155. `FIGURE_LIBRARY_DIR` is an admin override only.
  156. ## Tools (short list)
  157. | Tool | Role |
  158. | --- | --- |
  159. | `figure_library_plan_bind_global` / `apply_bind_global` | Choose the local Library directory |
  160. | `figure_library_open` | Open the MCP App |
  161. | `figure_library_search` | Search Local Published (and any enabled extras) |
  162. | `figure_library_plan_working_revision` / `apply_working_revision` | Import a figure+code unit |
  163. | `figure_library_plan_publish_working_revision` / `apply_publish_working_revision` | Publish a Release |
  164. | `figure_library_plan_open_figure_module_pr` / `apply_open_figure_module_pr` | Optional Open Figure Modules GitHub PR |
  165. | `figure_library_plan_materialize` / `apply_materialize` | Copy a confirmed template into a project |
  166. The server never runs notebooks, installers, or plot scripts. See
  167. [SECURITY.md](SECURITY.md).
  168. ## Open Figure Modules
  169. Personal modules use one content repository for both cleaned source modules and
  170. deterministic archives (no second archive repository):
  171. ```text
  172. <PERSONAL_MODULE_REPOSITORY>
  173. ├── modules/<moduleId>/ # reviewed, cleaned public module
  174. ├── archives/<moduleId>.zip # deterministic ZIP from a pinned source commit
  175. └── catalog/ # archive manifest and admission records
  176. ```
  177. The plugin still ships `assets/personal-modules/` as a bootstrap Catalog,
  178. preview/thumbnail snapshot, and license notice. After a successful signed-feed
  179. refresh, search uses the remote last-known-good overlay instead of that
  180. bootstrap. The plugin never contains complete personal ZIPs, Gallery
  181. source/reference images, private data, credentials, or signing keys.
  182. At runtime, complete Open Figure Modules are kept outside the plugin in the
  183. bound global Library under `source-packs/open-modules/`. A verified archive
  184. download is persisted there together with an extracted template cache. The
  185. canonical archive identity remains the GitHub repository and pinned commit;
  186. the bundled Catalog includes the official Gitee mirror
  187. `https://gitee.com/livenever/ScientificFigureLibrary-personal/raw/{archiveCommit}/{archivePath}`
  188. as the default transport accelerator and falls back to the canonical GitHub
  189. archive when unavailable. An optional machine-local mirror override can take
  190. precedence without changing canonical identity. Local Published templates continue
  191. to be read directly from the Library `store/` and never use this Source Pack.
  192. FigureYa follows the same write-through rule in the sibling
  193. `source-packs/figureya/` directory: a verified network archive is retained as a
  194. ZIP, indexed by `figureya-source-pack.manifest.json`, and extracted into the
  195. derived `templates/` cache. Preview and search remain read-only; this happens
  196. only during the approved Materialize Apply operation.
  197. The signed feed lives on the `open-figure-feed` branch of
  198. `jarxunlai/ScientificFigureLibrary-personal`. SFL checks
  199. `current/source-manifest.json` over HTTPS, verifies the Ed25519 detached
  200. signature, then pins Catalog and preview ZIP URLs to a payload commit. Search
  201. does not wait for the network. `figure_library_list_provider_sources` stays
  202. offline. Explicit `update` still uses Plan/Apply. `configure` may only change
  203. `autoRefresh`. Add/remove/trust-reset of this official channel are rejected.
  204. The maintainer commands are offline and deliberately separate from GitHub
  205. operations:
  206. ```bash
  207. npm run modules:validate -- --check --repository <PERSONAL_MODULE_REPOSITORY>
  208. npm run modules:archive -- --write --repository <PERSONAL_MODULE_REPOSITORY>
  209. npm run modules:catalog -- --write --repository <PERSONAL_MODULE_REPOSITORY>
  210. npm run modules:source-pack -- --write --repository <PERSONAL_MODULE_REPOSITORY>
  211. ```
  212. They do not create commits, push, create repositories, run R, install
  213. dependencies, or modify the Gallery. SFL materialization only downloads
  214. or reads the selected ZIP, validates its bytes and safe paths, extracts the
  215. requested `template`/`full` file set, and writes a lock with
  216. `codeExecutedBySflClient: false`.
  217. ## License
  218. MIT for this project's code. User-imported figures keep the license recorded
  219. at import. Optional bundled catalog assets, if used, keep their upstream
  220. licenses. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

Version history

  • v0.9.311/14/2026

  • v0.9.210/27/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.