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 分