opticquiz-cvd-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vince Gonzalez (OpticQuiz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# opticquiz-cvd-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that lets an LLM call the OpticQuiz
+colorblind-safe checker as a native tool. Built on the `opticquiz-cvd` engine
+(Machado 2009 + CIEDE2000). Runs locally over stdio; nothing leaves your machine.
+
+## Tools
+- **check_palette** — `{ colors: string[] }` → whether the palette stays distinguishable under protan/deutan/tritan, with the conflicting pairs.
+- **simulate_color** — `{ color: string, type: "protan"|"deutan"|"tritan" }` → how that color appears under that deficiency.
+
+## Add it to Claude Desktop
+Edit `claude_desktop_config.json` (Settings → Developer → Edit Config) and add:
+```json
+{
+  "mcpServers": {
+    "opticquiz-cvd": {
+      "command": "npx",
+      "args": ["-y", "opticquiz-cvd-mcp"]
+    }
+  }
+}
+```
+Restart Claude Desktop. Then ask, e.g., *"Is this palette colorblind-safe: #d7191c, #1a9641, #2166ac?"* — it calls the tool. Same config shape works in Cursor and other MCP clients.
+
+## Note
+A screening aid, not a legal accessibility (ADA/WCAG) audit. Method:
+Machado, Oliveira & Fernandes (2009) + CIEDE2000 — https://doi.org/10.5281/zenodo.21310578

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "opticquiz-cvd-mcp",
+  "version": "1.0.0",
+  "description": "MCP server that exposes the OpticQuiz colorblind-safe palette checker as callable tools for LLMs (Claude, Cursor, etc.).",
+  "type": "module",
+  "bin": {
+    "opticquiz-cvd-mcp": "server.js"
+  },
+  "main": "server.js",
+  "files": [
+    "server.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "colorblind",
+    "accessibility",
+    "a11y",
+    "llm",
+    "tool",
+    "opticquiz",
+    "cvd"
+  ],
+  "author": "Vince Gonzalez",
+  "license": "MIT",
+  "homepage": "https://opticquiz.com/checker/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zengineco/opticquiz.com"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "opticquiz-cvd": "^1.0.0",
+    "zod": "^3.23.0"
+  }
+}

package/server.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import cvd from "opticquiz-cvd";
+
+const server = new McpServer({ name: "opticquiz-cvd", version: "1.0.0" });
+
+server.registerTool(
+  "check_palette",
+  {
+    title: "Check a color palette for colorblind-safety",
+    description:
+      "Check whether a set of colors stays distinguishable for people with color-vision deficiency (colorblindness). Simulates protanopia, deuteranopia and tritanopia and flags the pairs whose perceptual difference collapses under simulation. A screening aid, not a legal accessibility (ADA/WCAG) audit.",
+    inputSchema: {
+      colors: z
+        .array(z.string())
+        .describe('Hex colors to check together, e.g. ["#d7191c","#1a9641","#2166ac"]')
+    }
+  },
+  async ({ colors }) => {
+    const r = cvd.checkPalette(colors);
+    const lines = [r.pass ? "PASS - colorblind-safe." : "FAIL - color conflicts found."];
+    for (const t of ["protan", "deutan", "tritan"]) {
+      const c = r.types[t].conflicts;
+      if (c.length)
+        lines.push(`${t}: ` + c.map((x) => `${x.a}/${x.b} (delta ${x.normal}->${x.sim}, ${x.severity})`).join("; "));
+    }
+    return { content: [{ type: "text", text: lines.join("\n") + "\n\n" + JSON.stringify(r) }] };
+  }
+);
+
+server.registerTool(
+  "simulate_color",
+  {
+    title: "Simulate a color under colorblindness",
+    description: "Return how a single hex color appears to someone with a given type of color blindness (protan, deutan, or tritan).",
+    inputSchema: {
+      color: z.string().describe("Hex color, e.g. #d7191c"),
+      type: z.enum(["protan", "deutan", "tritan"]).describe("Color-vision deficiency type")
+    }
+  },
+  async ({ color, type }) => ({
+    content: [{ type: "text", text: `${color} -> ${cvd.simulate(color, type)} (as seen with ${type})` }]
+  })
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("opticquiz-cvd MCP server running on stdio");