Skip to main content

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

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

looba_mcp-1.1.1.tar.gz (21.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

looba_mcp-1.1.1-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file looba_mcp-1.1.1.tar.gz.

File metadata

  • Download URL: looba_mcp-1.1.1.tar.gz
  • Upload date:
  • Size: 21.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for looba_mcp-1.1.1.tar.gz
Algorithm Hash digest
SHA256 784d826733089dc6bc62bb5e956f897a33bac5d13ea9ad528169eab6ce08b2fc
MD5 9c12d6463a6f0403f02f8fa59125cca7
BLAKE2b-256 97b50fc05c8941c924741fd79333f7d959798bc19844d677a8b1883c05afbd62

See more details on using hashes here.

File details

Details for the file looba_mcp-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: looba_mcp-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 20.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for looba_mcp-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c10e126fba6ed7c1bf976b219b05fca602959f952c4160df9cb0e0b4ee3ce045
MD5 96d74258dce1d70cb276fbcc4eb3debd
BLAKE2b-256 cde6f216808edb7444d0958ea95768787afe2784270dd6c97a8fb2e9a70fa06f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page