Cvdsafe

io.github.vince-gonzalez由 GitHub 帳號 vince-gonzalez 發布v0.2.0更新於 Oct 25, 2026

Check if a palette or image is colorblind-safe, generate safe palettes, check WCAG contrast.

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理檢查調色盤或影像是否對色盲友善、產生安全調色盤，並檢查 WCAG 對比度。

可以做什麼
檢查調色盤是否對色盲友善，依據色覺缺陷模擬與色差計算，並給出可用於 CI 檢查的通過或失敗結果。產生對色盲友善的調色盤，包括經核驗的 Okabe–Ito 系列。檢查顏色之間的 WCAG 對比度。README 還介紹了相關套件，用於將影像重新著色以模擬紅色、綠色與藍色覺缺陷、設定 matplotlib 顏色循環，以及產生石原式測試圖版，並稱助理可將圖版產生為原生工具。
適用情境
適合在設計圖表、地圖、儀表板或介面配色時，讓助理實際核驗無障礙性而不是憑猜測。也適合需要調色盤通過色盲安全測試的 CI 式檢查。
執行需求
以 stdio 本機程序方式執行，從 npm 套件 cvdsafe-mcp 安裝。未宣告任何身分驗證、環境變數或請求標頭。README 還提到 Python 套件與命令列工具，但 MCP 伺服器本身是 npm 套件。
安裝前請注意
README 說明一切都在本機執行，無需帳號、不上傳，因此未顯示需要憑證或向第三方傳輸資料。README 也指出網頁上的視力測試不能作為診斷，且未經臨床驗證；此類輸出應視為參考資訊，而非醫療建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cvdsafe，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

╔════════════════════════════════════════════════════════════════════════════════════════════╗║                                                                                            ║║              ██████╗ ██████╗ ████████╗██╗ ██████╗ ██████╗ ██╗   ██╗██╗███████╗             ║║             ██╔═══██╗██╔══██╗╚══██╔══╝██║██╔════╝██╔═══██╗██║   ██║██║╚══███╔╝             ║║             ██║   ██║██████╔╝   ██║   ██║██║     ██║   ██║██║   ██║██║  ███╔╝              ║║             ██║   ██║██╔═══╝    ██║   ██║██║     ██║▄▄ ██║██║   ██║██║ ███╔╝               ║║             ╚██████╔╝██║        ██║   ██║╚██████╗╚██████╔╝╚██████╔╝██║███████╗             ║║              ╚═════╝ ╚═╝        ╚═╝   ╚═╝ ╚═════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝╚══════╝             ║║                                                                                            ║║                 your eyes, tested in the browser, with nothing leaving it                  ║║                                                                                            ║╚════════════════════════════════════════════════════════════════════════════════════════════╝

An open, published method for color vision — and 17 vision tests built on it. Everything runs on the device. No account, no upload, no image ever sent anywhere.

The colorimetry is not a private formula: it is Machado, Oliveira & Fernandes (2009) deficiency simulation with CIEDE2000 color difference, published open access at doi.org/10.5281/zenodo.21310578, and shipped as packages so you can run the math yourself and check our numbers against yours.

Use the engine

bash
pip install cvdsafe          # is this palette colorblind-safe?npm  install cvdsafe
python
import cvdsafecvdsafe.is_safe(["#d7191c", "#1a9641"])   # False — red and green collapse under deutan
bash
npx cvdsafe "#d7191c" "#1a9641"           # exits 2 if the palette is unsafe — CI-friendly
what you wantpackage
Is this palette safe?cvdsafe · npm + PyPI, with a CLI
Show me how it lookscvdsim — recolors an image for protan/deutan/tritan
Give me safe colorssafepalette — Okabe–Ito, extended and verified
For matplotlibcvdmaps — set_cycle() and you're safe
Make test platescvdplate · ishihara
Acuity mathlogmar — logMAR ↔ Snellen ↔ decimal
One deficiencyprotan · deutan · tritanopia · dichromacy · achromatopsia · trichromacy

For LLM tools: cvdsafe-mcp and colorblind-mcp are MCP servers, listed in the official Model Context Protocol registry — so an assistant can check a palette or generate an Ishihara plate as a native tool.

The tests

Color vision, D-15 arrangement, hue discrimination, anomaloscope-style matching, contrast sensitivity, acuity, astigmatism, Amsler grid, blind spot, vernier alignment, flicker fusion, saturation, dominance, reaction, stereo depth, digital eye strain, and a shape-based test for kids.

A test on a web page cannot be a diagnosis: an uncalibrated display, ambient light and viewing distance all move the result. Each test says so where it reports, and points at an eye examination rather than standing in for one.

Audit it yourself. opticquiz.com/methodology answers the eight questions worth asking of any online vision test — who made it, what it measures, what it assumes about your screen, whether it has been clinically validated (it has not), what it cannot measure, and who pays for it.

Also in here

Translations (de, es, fr, hi, it, pt, zh), a browser extension (reviewed and listed by Mozilla), a VS Code extension, a Figma plugin, an embeddable widget, and the research notes behind the plate colors under research/.

MIT licensed. Issues and corrections welcome — if a number here disagrees with yours, that is a bug worth reporting.

╔════════════════════════════════════════════════════════════╗║                                                            ║║      ███████╗      ██╗  ██╗███████╗██╗   ██╗███████╗       ║║      ██╔════╝      ██║ ██╔╝██╔════╝╚██╗ ██╔╝██╔════╝       ║║      █████╗  █████╗█████╔╝ █████╗   ╚████╔╝ ███████╗       ║║      ██╔══╝  ╚════╝██╔═██╗ ██╔══╝    ╚██╔╝  ╚════██║       ║║      ██║           ██║  ██╗███████╗   ██║   ███████║       ║║      ╚═╝           ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚══════╝       ║║                                                            ║║               ·   C  R  E  A  T  I  V  E   ·               ║║                                                            ║║          ────────────────────────────────────────          ║║                                                            ║║                      Vincent Gonzalez                      ║║                         f-keys.com                         ║║                 ORCID 0009-0005-3640-014X                  ║║                                                            ║╚════════════════════════════════════════════════════════════╝

Part of F-Keys — independent hardware, software and internet products. See the working log and live status.

來源：README.md，提交 9e2fdfb

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分