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。Slugs にはカテゴリの接頭辞は含まれません（occams-razor-law-in-ux-design であり、ux-laws/occams-razor-law-in-ux-design ではありません）。

キャッシュ

ツール呼び出しは、毎回 API を呼び出す代わりにローカルのカタログキャッシュ（既定 TTL 24h）を読み込みます。優先順位は以下の通りです:

古い場合? refresh_hint_catalog を呼ぶか、TTL の期限切れを待ってください。同梱スナップショットが公開時点より古くなっている場合は、postinstall フックがユーザーキャッシュを自動的にウォームアップします。

詳細

クレジット

すべてのコンテンツは © [ux** Paul Capcan によるものです。このサーバーは、このサイトの公開 API をラッスするだけであり、コンテンツをホストしてしたり変しすることはありません。