🧭 Navbar Gallery Model Context Protocol (MCP) Server

An intelligent Model Context Protocol (MCP) server and CLI for querying, searching, and previewing curated navigation bar components from navbar.gallery. Built for AI coding assistants (Claude Desktop, Cursor, Antigravity) to inject real-world UI design inspiration directly into coding sessions.

📐 System Architecture

flowchart LR
    AI["AI Coding Assistant (Claude, Cursor, Antigravity)"] -->|JSON-RPC Tool Call| MCP["MCP Server Interface (dist/mcp.js)"]
    MCP --> Cache["10-Minute In-Memory TTL Cache"]
    Cache --> Limiter["Rate Limiter (600ms Gap & Exponential Backoff)"]
    Limiter --> Parser["Robots.txt Validator & HTML Scraper (Cheerio)"]
    Parser --> Result["Structured Navbar Component Data (Title, Category, Tags, URL)"]
    Result --> AI

Related MCP server: ui-architect-mcp

🌟 Key Features

1. Seamless AI Assistant Integration:

   • Exposes native MCP tools (list_types, list_navbars, search_navbars, get_navbar) for instant query-driven design inspiration.

2. Built-in Scraping Safety & Etiquette:

   • Robots.txt Compliant: Strictly respects robots.txt paths.

   • Rate-Limited: 600ms gap between live requests with 2 automatic retries on rate limits or network hiccups.

   • In-Memory Caching: 10-minute cache prevents redundant queries to upstream endpoints.

3. Dual Interface (CLI + MCP):

   • Can be used as a standalone terminal CLI (node dist/cli.js search stripe) or as an autonomous MCP background server.

🚀 Setup & Build

# Install dependencies & build TypeScript
npm install
npm run build

# CLI Testing:
node dist/cli.js list dropdowns
node dist/cli.js search stripe --type all

Claude Desktop / Antigravity MCP Configuration:

{
  "mcpServers": {
    "navbar-gallery": {
      "command": "node",
      "args": [
        "C:\\path\\to\\navbar-gallery-mcp\\dist\\mcp.js"
      ]
    }
  }
}

⚖️ Intellectual Property & License

Copyright (c) 2026 Kartik. All Rights Reserved.

This repository and its source code are published for viewing, evaluation, and portfolio demonstration purposes only. No permission is granted to reproduce, distribute, modify, deploy, or commercially exploit this software. See the LICENSE file for complete legal terms.