Uwarp

io.github.sherotree由 GitHub 帳號 sherotree 發布v1.0.0更新於 Oct 24, 2026

WCAG contrast checks, HSL palettes with :root CSS, and search of 500+ free Uwarp UI tools.

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

概覽

AI 產生的概覽

Uwarp 的本機 MCP 伺服器，可檢查 WCAG 對比度、產生附 :root CSS 的 HSL 調色盤，並搜尋內建的 UI 工具目錄。

可以做什麼
  • 檢查兩個十六進位顏色之間的 WCAG 2.x 對比度，並給出一般文字與大字的 AA/AAA 判定
  • 產生 HSL 和諧配色（類似色、互補色、三角色、單色），輸出顏色名稱與可直接貼上的 :root CSS
  • 依關鍵字搜尋內建的 Uwarp UI 工具目錄，可依分類篩選並限制回傳數量
適用情境
適合在 Cursor 或 Claude Desktop 等編輯器中開發或檢視介面時，快速做無障礙對比度檢查、產生配色，或不必離開對話就能查詢 Uwarp 工具項目。
執行需求
需要 Node.js 18 以上版本；以 stdio 方式在本機執行，通常透過 npx 或建置後的 dist 進入點啟動。不需要 API 金鑰或帳號；UWARP_API_KEY 變數為預留項目，目前會被忽略。
安裝前請注意
工具搜尋只讀取內建的少量範例目錄（約 28 筆），執行時不會連線 uwarp.design，因此結果有限且可能過時。對比度與配色計算完全在本機完成，目前不要求任何憑證。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

uwarp-mcp

[sherotree/uwarp-mcp MCP server]

MCP server for Uwarp — a directory of 500+ free browser UI tools.

This package exposes three local tools you can use from Cursor or Claude Desktop. No paid API key is required. Most Uwarp listings are third-party embeds; this server does not scrape or wrap them. Contrast and palette math run entirely on-device; search_tools reads a bundled local catalog (data/tools.json).

ToolPurpose
check_contrastWCAG 2.x contrast ratio + AA/AAA flags
generate_paletteHSL harmony palettes + :root CSS
search_toolsSearch the local Uwarp tool catalog

Author / context: Sherotree · https://uwarp.design · MIT

Install via npx

No clone needed. Add to your MCP client config (Cursor mcp.json, Claude Desktop, etc.):

json
{  "mcpServers": {    "uwarp": {      "command": "npx",      "args": ["-y", "uwarp-mcp"]    }  }}

Requirements

  • Node.js 18+

Install & build

bash
cd /path/to/uwarp-mcpnpm installnpm run build

Test

bash
npm test

Includes a check that black-on-white contrast ≈ 21.

Run locally (stdio)

bash
npm start# or during development:npm run dev

The process speaks MCP over stdio (JSON-RPC on stdin/stdout). Log noise goes to stderr.

Optional env stub

VariableNotes
UWARP_API_KEYReserved for a future Uwarp API. Ignored today — no paid key needed.

Cursor (mcp.json)

Add to your Cursor MCP config (e.g. ~/.cursor/mcp.json or project .cursor/mcp.json). Point args at the built entry after npm run build:

json
{  "mcpServers": {    "uwarp": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/uwarp-mcp/dist/index.js"]    }  }}

Example if the project lives at ~/code/uwarp-mcp (use the absolute path):

json
{  "mcpServers": {    "uwarp": {      "command": "node",      "args": ["/Users/you/code/uwarp-mcp/dist/index.js"]    }  }}

Restart Cursor (or reload MCP servers) after saving.

Claude Desktop

Edit the Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "uwarp": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/uwarp-mcp/dist/index.js"]    }  }}

Restart Claude Desktop after saving.

Tool reference

check_contrast

Input

FieldTypeDescription
foregroundstringHex #RGB / #RRGGBB
backgroundstringHex #RGB / #RRGGBB

Output

json
{  "ratio": 21,  "aa_normal": true,  "aa_large": true,  "aaa_normal": true,  "aaa_large": true}

Uses WCAG 2.x relative luminance and contrast ratio thresholds (AA normal ≥ 4.5, AA large ≥ 3, AAA normal ≥ 7, AAA large ≥ 4.5).

generate_palette

Input

FieldTypeDefaultDescription
seedstring—Seed hex
harmonyanalogous | complementary | triadic | monoanalogousHarmony mode
countnumber6Colors, 3–12

Output

json
{  "colors": [{ "name": "Mid Blue", "hex": "#3b82f6" }],  "css": ":root {\n  --color-1: #3b82f6; /* Mid Blue */\n}"}

search_tools

Input

FieldTypeDefaultDescription
querystring—Search text
categorystring—Optional filter (e.g. color, svg-generators)
limitnumber8Max results, 1–20

Output

json
{  "tools": [    {      "name": "Contrast Checker",      "summary": "…",      "url": "https://uwarp.design/tools/contrast-checker",      "category": "color"    }  ]}

Note: search_tools uses the local catalog in data/tools.json (sample entries for development). It does not scrape uwarp.design at runtime.

Project layout

uwarp-mcp/├── data/tools.json          # Local Uwarp catalog (~28 samples)├── src/│   ├── index.ts             # MCP stdio entry│   └── tools/│       ├── check_contrast.ts│       ├── generate_palette.ts│       └── search_tools.ts├── tests/├── dist/                    # After npm run build├── package.json├── tsconfig.json├── LICENSE└── README.md

License

MIT © Sherotree / Uwarp

來源：README.md，提交 2788dee

工具

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

版本歷史

1
  1. v1.0.0最新Oct 15, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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