looba-mcp 1.1.0

MCP server for browsing Looba UI snippets — search posts, read code, and discover authors.

Looba MCP Server

An MCP server that gives AI assistants read-only access to Looba — a community platform for UI snippets and design inspiration.

No API key required. No database credentials. The server calls the public Looba API over HTTPS.

Install

npx (no install needed)

npx looba-mcp

npm

npm install -g looba-mcp

pip

pip install looba-mcp

git

git clone https://github.com/Loobadev/looba-mcp.git
cd looba-mcp
npm install

All methods require Node.js 18+ installed on your machine.

Tools

Tool	Description
list_posts	Search and browse snippet posts with filters (tag, type, sort)
get_post	Get full HTML/CSS/JS code of a post with author attribution
integrate_post	Fetch a snippet with integration instructions adapted to your project's CSS, framework, and conventions
search_by_author	List all posts by a specific author
get_popular_tags	Discover trending tags across the platform

integrate_post

The integrate_post tool is designed for when you want to add a Looba snippet directly into your codebase. It fetches the full code and returns it with a detailed adaptation checklist so the AI assistant can:

• Rename CSS classes to match your naming convention (BEM, camelCase, CSS modules...)
• Replace hardcoded colors/spacing with your CSS variables or design tokens
• Convert between frameworks (vanilla HTML to React JSX, CSS to Tailwind utilities...)
• Scope styles to avoid conflicts with your global CSS
• Add proper imports and follow your component patterns

Example prompt:

"Use integrate_post to add the animated-circle-loaders-html-css-10 snippet to my Next.js project that uses Tailwind and CSS variables"

The AI will fetch the snippet, read your project context, and produce adapted code ready to paste.

Supported snippet types

Type	Code fields returned
classic	HTML, CSS, JavaScript
react	JSX, Styles (CSS), HTML (host)
tailwind	HTML (with Tailwind classes), CSS, JavaScript

Setup

Claude Code

Add to your project .mcp.json or ~/.claude/settings.json:

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

Cursor

Go to Settings > MCP Servers > Add Server:

• Name: looba
• Command: npx -y looba-mcp

Windsurf

Add to ~/.windsurf/mcp.json:

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

Using pip or git install

If you installed via pip or git clone, use looba-mcp or node directly:

{
  "mcpServers": {
    "looba": {
      "command": "looba-mcp"
    }
  }
}

Or with git clone:

{
  "mcpServers": {
    "looba": {
      "command": "node",
      "args": ["/path/to/looba-mcp/index.js"]
    }
  }
}

Examples

Once connected, ask your AI assistant things like:

• "Show me the most popular CSS snippets on Looba"
• "Find Looba posts tagged with animation"
• "Get the code for the post animated-circle-loaders-html-css-10"
• "List all posts by @Frontend-snippet-Bot"
• "Integrate the focus-trapped-navigation-controller snippet into my React project using CSS modules"

Every response includes source URL, author, and license — so AI assistants always cite properly.

License

MIT