uxspot-mcp

uxspot MCP 服务

AI 助手可调用的 UX 参考资料——现在还能绘制图示。

uxspot.io 是免费的精选 UX 参考资料：包含 203 个术语的词汇表（每个术语都附有通俗易懂的定义和「为何重要」说明）、AI x UX 工具目录、5 份交互式检查清单、包含 78 个主题的 Learn UX 课程，以及每日 UX 词汇游戏 Spot Check。本仓库介绍了远程 Model Context Protocol 服务，它将所有内容作为可调用工具提供给 Claude、Cursor 和其他 MCP 客户端。

• 端点： https://uxspot.io/mcp — 远程、Streamable HTTP、无状态
• 落地页和在线演示： uxspot.io/mcp-server
• 身份验证： 无——无需密钥、账号，也无需注册以获得速率限制
• 隐私： 所有工具均为只读，仅访问 uxspot.io 的公开内容。服务不会看到你的项目、文件或账号。
• 关联项目： uxspot Figma 插件——在 Figma 中作为设计导师提供同一份参考资料，现已在 Figma Community 上线。

安装

Claude Code

claude mcp add --transport http uxspot https://uxspot.io/mcp

Claude Desktop — 前往 Settings → Connectors → Add custom connector，并填写 URL https://uxspot.io/mcp。

Cursor — 添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "uxspot": { "url": "https://uxspot.io/mcp" }
  }
}

Gemini app (Spark) — 前往 Settings → Connected apps → 添加自定义应用，并将 https://uxspot.io/mcp 粘贴为 URL（只需填写 URL——下方的 JSON 是 Antigravity 的格式，不适用于 Spark）。如果 Advanced 下出现凭据步骤，请留空；uxspot 从不要求提供密钥。

Gemini (Antigravity) — 取代 Gemini CLI 的 IDE 和命令行工具。添加到 ~/.gemini/config/mcp_config.json，然后在命令行中运行 /mcp 以确认：

{
  "mcpServers": {
    "uxspot": { "serverUrl": "https://uxspot.io/mcp" }
  }
}

Gemini Enterprise 是 Gemini 中唯一无法接入的选项：它要求由管理员注册 OAuth 连接器，而 uxspot 从设计上就不使用密钥。

其他任何支持 Streamable HTTP 传输的 MCP 客户端，都可以将其指向 https://uxspot.io/mcp。

工具

工具	参数	返回内容
search_glossary	query	匹配的 UX 术语及其定义和来源 URL
define_term	term	单个术语的完整信息：定义、为何重要、参考编号、空间概念的终端图示，以及来源 URL
list_ux_tools	category?	精选的 AI x UX 工具目录，可按类别筛选
list_checklists	—	5 份检查清单及其主题和条目数量
get_checklist	slug	一份检查清单的完整内容：所有主题和条目
search_curriculum	query	匹配的 Learn UX 主题及其 HTML 和 Markdown URL
get_curriculum	—	完整的 Learn UX 课程大纲
spot_check	—	Spot Check 词汇游戏的一轮内容：一个术语、一条可能匹配也可能不匹配的定义、答案及说明

每个回答都会注明其 uxspot.io 来源 URL，方便你（以及你的助手）核实。

回答示例

define_term("60-30-10") 会原样返回：

**60-30-10 rule**
A color-proportion guideline borrowed from interior design: roughly 60% of a
screen in a dominant, usually neutral color, 30% in a secondary color, and 10%
in an accent reserved for emphasis — enough color to guide the eye without
competing for it.

**Why it matters** — Screens that feel colorful but calm almost always follow
some version of this split. Inverting it — letting the accent become the
majority — is why loud interfaces feel loud: when everything asks for
attention with color, nothing gets it.

**The numbers**
- 60% — dominant, usually neutral
- 30% — secondary, supporting surfaces
- 10% — accent, reserved for emphasis and actions

┌────────────────────────────────────┐
│                                    │
│      60% — dominant, neutral       │
│                                    │
├─────────────────────────┬──────────┤
│    30% — secondary      │ 10%      │
│                         │ accent   │
└─────────────────────────┴──────────┘

Source: https://uxspot.io/glossary/60-30-10-rule

终端图示

37 个空间概念——比例、位置、层级、流动——用手绘框线图示呈现：Z 字形的浏览路径、包含错放页面的信息架构树、情绪跌落的旅程地图、分为四个象限的共情地图，以及穿透暗色页面的模态框。

这组图示的范围经过刻意限制。示例需要颜色（对比度、眼动热图）、动态效果（骨架屏闪烁）或交互（菲茨定律的计时器、蔡加尼克效应的清单）的术语，不会用效果更差的方式仿造，而是指向 uxspot.io 上的实时交互示例。有些内容也确实无法用等宽字体展示：在终端里绘制字偶间距图会与主题本身相矛盾，因为按定义，每个字形的宽度都相同。

每幅图示都是手工绘制，绝不自动生成，保存在 src/lib/glossaryAscii.ts 中——和这里的其他内容一样，均可检查；该文件还记录了完整的判断过程，说明哪些内容要绘制、哪些要指向实时演示，以及原因。

试试看

可以向你的助手询问：

• “什么是 Z 字形？画出来看看。”
• “UX 中的可供性是什么？在哪里能了解更多？”
• “列出用于 UX 研究的 AI 工具”
• “给我无障碍检查清单”
• “在课程内容中搜索可用性测试”
• “考考我 UX 词汇”（逐轮进行 Spot Check）

构建方式

该服务是在静态 uxspot.io 网站前运行的单个 Cloudflare Pages Function。每个 POST 请求都是一次完整的 JSON-RPC 交互（无状态 Streamable HTTP——无会话、无数据库）；工具读取的数据与实时网站使用的结构化数据相同，因此响应始终与已发布内容保持同步。工具描述甚至会根据数据文件自动统计数量，确保上面的数字不会过时。

server/ 中的代码和 src/lib/ 中的图示映射，是已部署函数的只读镜像，在此发布以提高透明度，并供 MCP 目录收录。权威源位于 uxspot 主网站仓库；该函数导入的数据文件（glossary.json、tools.json、checklists.json、curriculum.ts）也在那里，因此这个镜像仅供阅读，不用于构建。

许可证

本仓库中的服务代码根据 MIT License 发布。工具所提供的 uxspot.io 内容（定义、检查清单、课程内容）仍归 Soufiane Chraibi 所有，© Soufiane Chraibi；内容授权仅限通过网站及此 API 使用，不得批量再分发。