mcp-uxhints

MCP-сервер (Model Context Protocol), который предоставляет каталог uxhints.com — коротких UX- и продуктовых подсказок — в виде MCP-инструментов через stdio. Контент берётся из публичного 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. Слаги никогда не содержат префикс категории (occams-razor-law-in-ux-design, а не ux-laws/occams-razor-law-in-ux-design).

Кэширование

Вызовы инструментов читают локальный кэш каталога (TTL по умолчанию 24 часа) вместо обращения к API при каждом вызове. Порядок разрешения:

Кэш не свежий? Вызовите refresh_hint_catalog или дождитесь истечения TTL. Хук postinstall автоматически прогревает пользовательский кэш, если встроенный снимок уже устарел с момента публикации.

¹ ~/.cache/mcp-uxhints на Linux (учитывается XDG_CACHE_HOME), ~/Library/Caches/mcp-uxhints на macOS, %LOCALAPPDATA%\mcp-uxhints\Cache на Windows.

Детали

Авторство

Весь контент © uxhints.com от Paul Capcan. Этот сервер лишь оборачивает публичный API сайта; он не размещает и не изменяет контент.