Skip to main content
Glama

<<<<<<< HEAD

COLLECT-UI-MCP-SERVER

=======

🎨 Collect UI MCP

Your AI assistant's personal UI component library

Collect Β· Search Β· Recall β€” every snippet, right inside your editor.

npm MCP License Node PRs

Quick Start Β· Features Β· Tools Β· Examples Β· Contributing


🧠 Stop scrolling bookmarks. Start asking.

You: "Save this button as neon-button, tag it tailwind and dark."

Assistant: βœ… Collected β€” 24 lines saved to your library.


✨ Why Collect UI MCP?

😩 The old way

  • πŸ”– 47 bookmarks named "cool button"

  • πŸ“ A folder called snippets-final-v2-USE-THIS

  • 🧠 You know you saved that card somewhere…

  • πŸ“‹ Copy-pasting from chat β†’ files β†’ chat β†’ files

✨ The new way

  • πŸ—£οΈ Ask your AI to save, find, or fetch components

  • 🏷️ Tag by framework, mood, or use-case

  • πŸ” Full-text search across your whole library

  • πŸ’Ύ Everything stays local and git-friendly


Related MCP server: journey-log

🎯 Features

Feature

Description

πŸ—‚οΈ

Collect

Save any UI snippet with a name, tags & description

πŸ”

Search

Find components by keyword, tag, or framework

🏷️

Organize

Tag by stack β€” React, Vue, Tailwind, CSS…

🧾

Retrieve

Pull full source code straight into chat

✏️

Update

Modify existing entries without leaving your editor

πŸ—‘οΈ

Delete

Clean up entries in seconds

πŸ’Ύ

Local-first

Nothing leaves your machine. Ever.

🧩

Framework-agnostic

Works with any UI stack you throw at it

⚑

Zero-config

Point at a folder. Done.


πŸš€ Quick Start

3 steps to a smarter UI library

Install β†’ Configure β†’ Ask

1️⃣ &nbsp; Install

# Global install
npm install -g collect-ui-mcp

# Or use on the fly
npx collect-ui-mcp

2️⃣ &nbsp; Configure your MCP client

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "collect-ui": {
      "command": "npx",
      "args": ["-y", "collect-ui-mcp"],
      "env": {
        "COLLECT_UI_DIR": "/absolute/path/to/your/ui-library"
      }
    }
  }
}

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "collect-ui": {
      "command": "npx",
      "args": ["-y", "collect-ui-mcp"],
      "env": { "COLLECT_UI_DIR": "/absolute/path/to/your/ui-library" }
    }
  }
}
{
  "mcpServers": {
    "collect-ui": {
      "command": "npx",
      "args": ["-y", "collect-ui-mcp"],
      "env": { "COLLECT_UI_DIR": "${workspaceFolder}/.ui-library" }
    }
  }
}

3️⃣ &nbsp; Restart your client

πŸŽ‰ Done. Your AI assistant now has the collect-ui toolset.


πŸ› οΈ Available Tools

&nbsp;

Tool

Description

πŸ“₯

collect_component

Save a UI snippet with name, code, tags & description

πŸ“‹

list_components

List all components β€” filterable by tag

πŸ”

search_components

Full-text search across names, tags, descriptions

πŸ“€

get_component

Fetch the full source + metadata of a component

✏️

update_component

Modify an existing entry

πŸ—‘οΈ

delete_component

Remove a component from your library

🏷️

list_tags

See every tag currently in use

πŸ“š Resources

URI

Description

collect-ui://library

Your entire catalog as JSON

collect-ui://component/{name}

A single component by name

πŸ’¬ Prompts

  • find-ui-component β€” Ask the AI for the best match to a design need

  • summarize-library β€” Get a quick overview of what you've collected


πŸ’‘ Example Usage

You   β†’  Save this Hero section as "gradient-hero",
         tagged react, tailwind, marketing.

AI    β†’  βœ… Collected "gradient-hero" (React Β· Tailwind)
         Saved 42 lines to your library.
You   β†’  What button variants do I have collected?

AI    β†’  You have 3:
         β€’ neon-button   β€” Tailwind Β· dark mode glow
         β€’ ghost-button  β€” CSS Β· minimal outline
         β€’ pill-button   β€” React Β· styled-components
You   β†’  Show me the source of "neon-button".

AI    β†’  [renders full code from your library]

πŸ—ƒοΈ How Data is Stored

Everything lives in a single folder you control:

my-ui-library/
β”œβ”€β”€ neon-button/
β”‚   β”œβ”€β”€ component.tsx
β”‚   └── meta.json          ← name, tags, description, timestamps
β”œβ”€β”€ gradient-hero/
β”‚   β”œβ”€β”€ component.tsx
β”‚   └── meta.json
└── .collect-ui-index.json

βœ… Human-readable

βœ… Git-friendly

βœ… No database

βœ… Yours forever


βš™οΈ Configuration

Env var

Default

Description

COLLECT_UI_DIR

./.ui-library

Where components are stored

COLLECT_UI_INDEX

.collect-ui-index.json

Index filename

COLLECT_UI_LOG

info

Log level β€” debug Β· info Β· warn Β· error


πŸ§ͺ Development

# Clone
git clone https://github.com/<your-username>/collect-ui-mcp.git
cd collect-ui-mcp

# Install & build
npm install
npm run build

# Watch mode
npm run dev

# Test
npm test

πŸ”¬ Debug with the MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

πŸ—ΊοΈ Roadmap

  • ☁️ Cloud sync β€” S3 / WebDAV

  • πŸ–ΌοΈ Image & screenshot attachments

  • 🧠 Framework-aware imports

  • 🎨 Figma plugin bridge

  • πŸ“Š Web dashboard

πŸ’‘ Have an idea? Open an issue β€” PRs are welcome!


🀝 Contributing

Every contribution counts β€” bugs, docs, ideas, code.

# 1. Fork the repo, then:
git checkout -b feat/my-feature
git commit -m "feat: add my feature"
git push origin feat/my-feature
# 2. Open a Pull Request πŸš€

Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before getting started.


πŸ™ Acknowledgements

  • 🧬 Model Context Protocol β€” the spec that makes this possible

  • 🏒 Anthropic β€” for building and open-sourcing MCP

  • 🫑 Everyone who has a folder called snippets-final-v3-USE-THIS-ONE


πŸ“„ License

MIT Β© <Your Name>

⭐ If this saved you a bookmark, star the repo!

Made with ❀️ and a mild obsession with clean components.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers