mcp-uxhints

MCP-Server (Model Context Protocol), der den Katalog von uxhints.com mit kompakten UX- und Produktdesign-Hinweisen als MCP-Tools über stdio bereitstellt. Die Inhalte stammen aus der öffentlichen WordPress-REST-API der Website (in sauberes Markdown konvertiert) und werden über einen lokalen Cache ausgeliefert, sodass Tool-Aufrufe sofort und auch offline funktionieren.

Installation mit npx (empfohlen)

Voraussetzung: Node.js 18 oder neuer. Kein Build-Schritt nötig – npx lädt das veröffentlichte Paket herunter und führt es aus, und der gebündelte Katalog-Snapshot ermöglicht den ersten Tool-Aufruf ganz ohne Netzwerk.

Registrieren Sie den Server in Ihrem MCP-Client und starten Sie den Client danach neu.

OpenCode

Fügen Sie zu opencode.json Folgendes hinzu:

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

Claude Desktop

Fügen Sie zu claude_desktop_config.json Folgendes hinzu:

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

Hinweis: Führen Sie npx mcp-uxhints nicht aus Ihrem eigenen Klon dieses Repositories aus – npm erkennt das lokale package.json und schlägt mit command not found fehl. In jedem anderen Verzeichnis funktioniert es.

Related MCP server: mcp-maintainer-toolkit

Installation aus dem Quellcode (Alternative)

Für die Entwicklung oder zum Fixieren eines lokalen Builds:

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

Richten Sie Ihren Client danach auf die gebaute Datei aus, statt auf npx:

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

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

Tools

Typischer Ablauf: list_categories → list_hints → get_hint. Slugs enthalten nie das Kategorie-Präfix (occams-razor-law-in-ux-design, nicht ux-laws/occams-razor-law-in-ux-design).

Caching

Tool-Aufrufe lesen aus einem lokalen Katalog-Cache (Standard-TTL: 24 h), statt bei jedem Aufruf die API zu kontaktieren. Die Auflösungsreihenfolge lautet:

Nicht frisch? Rufen Sie refresh_hint_catalog auf oder warten Sie, bis die TTL abläuft. Ein postinstall-Hook wärmt den Benutzer-Cache automatisch auf, wenn der gebündelte Snapshot seit der Veröffentlichung abgelaufen ist.

¹ Betriebssystem-Cache-Verzeichnis: ~/.cache/mcp-uxhints auf Linux (berücksichtigt XDG_CACHE_HOME), ~/Library/Caches/mcp-uxhints auf macOS, %LOCALAPPDATA%\mcp-uxhints\Cache auf Windows.

Details

Danksagung

Alle Inhalte © uxhints.com von Paul Capcan. Dieser Server kapselt lediglich die öffentliche API der Website; er hostet oder verändert die Inhalte nicht.