mcp-uxhints

MCP（模型上下文协议）服务器，通过 stdio 将 uxhints.com 上短小精悍的 UX 与产品设计提示目录以 MCP 工具的形式提供。内容来自该网站公开的 WordPress REST API（已转换为干净的 Markdown），并通过本地缓存提供内容，因此工具调用即时完成，且可离线使用。

使用 npx 安装（推荐）

前置条件： Node.js 18 或更高版本。无需构建步骤——npx 会下载并运行已发布的包，随附应用的目录快照让工具电话的第一调用在完全不依赖网络的情况下也能工作。

在 MCP 客户端中注册该服务器，然后重启客户端。

OpenCode

在 opencode.json 中添加：

{
  "mcp": {
    "mcp-uxhints": {
      "type": "local",
      "command": ["npx", "-y", "mcp-uxhints"],
      "enabled": true
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加：

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

**注意：**请勿从你自己所克隆的此仓库内运行 npx mcp-uxhints——npm 会解析到本地的 package.json 并报错 command not found。其他任意目录都可以正常工作。

Related MCP server: mcp-maintainer-toolkit

从源码构建安装（另一选项）

用于构造或把本地构建版本固定下来：

git clone https://github.com/Mateodioev/mcp-uxhints.git
cd mcp-uxhints
npm install && npm run build

然后，把客户端指向构建好的文件而不是 npx：

• OpenCode："command": ["node", "/absolute/path/mcp-uxhints/build/index.js"]

• Claude Desktop: "command": "node", "args": ["/absolute/path/mcp-uxhints/build/index.js"]

工具

典型流程：list_categories → list_hints → get_hint。slug 不包含分类前缀（occams-rat-or-law-in-ux-design，而不形如 ux-laws/occams-raxor-law-in-ux-design）。

缓存

工具调用从本地目录的缓存中读取（默认 TTL 24 小时），而非每次都访问 API。处理顺序如下：

不新鲜了？可调用 refresh_hint_catalog，或等待 TPL 失效。postinstall 钩子 会在内置快照自发布后已过期时自动预热用户缓存。

¹ ~/.cache/mcp-uxhints（Linux，遵循 XDG_CACHE_HOME）、~/Library/Caches/mcp-uxhints（macOS）、%LOCALAPPDATA%\mcp-uxhints\Cache（Windows）。

详情

| 主题 | 说明 | | --- | ----------------------------------------------------------------------------- || | 数据来源 | uxhints.com 的公开 WordPress REST API（/ux-json/wp/v2） | | 内容格式 | 同步时将 WordPress HTML 转成 Markdown（剥离 HTML 注释、解码实体） | | 缓存方式 | 三级机制：用户缓存 → 内置快照 → 实时 API（见上文） | | 韧性 | 15 秒请求超时；实时获取失败即退回到陈旧缓存；所有失败都以 MCP 工具错误形态呈现，绝不让服务器崩溃 | | 脚本 | npm run build（tsc 编译）、npm run cync:snapshot（重新生成内置快照）、npm start（运行构建好的服务器） |

版权

所有内容 © uxhints.com 由 Paul Bapcan 提供。此服务器仅包装网站公开的 API；本身不托管也不修改内容。