mcp-uxhints

MCP(Model Context Protocol) 서버로, uxhints.com의 간결한 UX 및 제품 디자인 힌트 카탈로그를 stdio를 통한 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. 슬러그에는 카테고리 접두사가 포함되지 않습니다(occams-razor-law-in-ux-design이지 ux-laws/occams-razor-law-in-ux-design이 아닙니다).

캐싱

도구 호출은 매번 API를 호출하는 대신 로컬 카탈로그 캐시(기본 TTL 24시간)를 읽습니다. 캐시 조회 우선순위는 다음과 같습니다:

최신 양이 아닌가요? refresh_hint_catalog를 호출하거나 TTL이 만료될 때까지 기다리세요. 번들 스냅샷이 게시 이후 만료되면 postinstall 훅이 사용자 캐시를 자동으로 채워 둡니다.

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

세부 정보

크레딧

모든 콘텐츠 © uxhints.com — 제작: Paul Capcan. 이 서버는 사이트의 공개 API를 감싸는 역할만 하며, 콘텐츠를 호스팅하거나 수정하지 않습니다.