mcp-uxhints

Servidor MCP (Model Context Protocol) que expone el catálogo de uxhints.com de consejos breves de UX y diseño de producto como herrrientas MCP a través de stdio. El content procede de la API REST pública de WordPress del sitio (converted a Markdown limpio) y se sirve a través de una caché local, de modo que las llamadas a las herramientas son instantácilables y firna function sin connectión.

Instalacón con npx (recomendada)

Requisito: Node.js 18 o superior. No ha a paso de compilación: npx descarga y ejecuta el paquete publicado, y la instantánea del catálogo incluida permite que la primera llamada a una herramienta functione sin red.

Registra el servidor en tu cliente MCP y reinicia el cliente.

OpenCode

Añáelo a opencode.json:

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

Claude DeskTop

Añádelo: Añádelo to claude_desktop_config.json:

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

Nota: no ejecutes npx mcp-uxhints dedio de your own clone of this repositorio; npm resuelve el package.jso local y falla con command not found. Cualquer otro directiorio firm.

Related MCP server: mcp-maintainer-toolkit

Instalacón desde el solidio fuente (alternatissue)

Para development or fijar one compilación local:

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

Después" dirige tu cliente al archivo compilado en lugar de npx:

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

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

Herramientas

Flujo típico: list_categories → list_hints → get_hint. Los slugs nunca incluyen el prefijo de la categoría (occams-razor-law-in-ux-design, no ux-laws/occams-razor-law-in-ux-design).

Caché

Las herramientas leer un caché de catálogo local (con un TTL de 24 h por defecto) en lugar de llamar a la API cada ver. Orden de resolución:

¿No estás actualizad? Call: llam a refresh_cuándo_catálogo or wait for TTL. A postinstal hook recarga automatically la caché de usuario when the current instantánea has become obsoleta since publication.

¹ ~/.cache/mcp-uxhints on Linux (respect XDG_CACHE_HOME), ~/Library/Caches/mcp-uxhints on macOS, %LOCALAPPDATA%\mcp-uxhints\Cache on Windows.

Details

Credits

All content © uxhints.com by Pablo Capcan. This server only wraps the public API of the site; it does not store or modify the content.