skill-search-mcp

v0.2.0

Published

19 days ago

Search Claude Code skills via MCP protocol

0High
0Medium
0Low

daymade

mcp claude claude-code skills model-context-protocol tool-search-tool ccpm

Claude Skills MCP Server

npm for Claude skills - Complete package management ecosystem via MCP protocol

MCP server that brings full package management capabilities to Claude Code skills. Search, install, manage, and discover skills from a centralized registry - all through natural conversation with Claude.

🎯 Quick Start

Installation

Choose any package name - they all work the same:

# Main package (recommended)
npx -y claude-skills-mcp

# Or use any alias
npx -y skills-search-mcp
npx -y mcp-skills
npx -y skill-discovery-mcp

Prerequisite: install the CCPM CLI first (npm install -g @daymade/ccpm). Registry-backed tools (info/popular/recent) require SUPABASE_ANON_KEY or VITE_SUPABASE_PUBLISHABLE_KEY.

Configuration

Add to your Claude Desktop config:

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

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

Restart Claude Desktop.

📦 Available Package Names

All packages contain the same code - choose any name you prefer:

| Package Name | Use Case | Install | |-------------|----------|---------| | claude-skills-mcp | Main package (recommended) | npx -y claude-skills-mcp | | skills-search-mcp | Tool Search Tool emphasis | npx -y skills-search-mcp | | mcp-skills | Short & simple | npx -y mcp-skills | | skill-discovery-mcp | Discovery focus | npx -y skill-discovery-mcp | | skill-search-mcp | Search emphasis | npx -y skill-search-mcp | | claude-skill-search | Claude-branded | npx -y claude-skill-search | | claude-code-skills-mcp | Fully descriptive | npx -y claude-code-skills-mcp | | claude-tool-search | Anthropic-style naming | npx -y claude-tool-search |

Why multiple names? Better SEO and discoverability - users can find us no matter what they search for.

💬 Usage

Just talk to Claude naturally:

You: "Find me a PDF processing skill"

Claude: [searches registry via MCP]
        Found "pdf-processor" by daymade (1.2k downloads)

        Description: Extract text and metadata from PDF files
        Tags: pdf, document-processing, text-extraction

        Install it?

You: "Yes"

Claude: [installs via MCP]
        ✅ Installed to ~/.claude/skills/pdf-processor
        ⚠️  Restart Claude Code to use this skill.

You: "Show me what skills I have installed"

Claude: [lists installed skills]
        You have 5 skills installed:

        📄 pdf-processor (v1.2.0)
        ✨ skill-creator (v2.1.0)
        🔧 mcp-builder (v1.0.3)
        📊 data-analyzer (v0.5.0)
        🌐 web-scraper (v1.4.2)

🛠️ Available Tools

| Tool | Description | Example Usage | |------|-------------|---------------| | search_skills | Full-text search with filters (query, tags, author, limit) | "Find PDF skills by daymade" | | discover_skills | Context-aware recommendations (smart search) | "Recommend skills for processing invoices" | | popular_skills | Most downloaded skills (limit, timeframe) | "Show top 5 this week" | | recent_skills | Newly published/updated skills (limit, days) | "What's new in the last 7 days" | | info_skill | Detailed skill info (detailed: true for extended metadata) | "Detail of pdf-processor with timestamps" | | install_skill | Install to user or project scope | "Install pdf-processor" | | list_skills | List installed skills | "Show my installed skills" | | uninstall_skill | Remove skill (user/project) | "Uninstall pdf-processor from project" |

popular_skills: timeframe 参数目前仅作为排序提示，待 Supabase 视图增强后会生效过滤。

✨ Features

🔍 Searchable Registry

Full-text search across skill names, descriptions, tags
Filter by author, popularity, recency, tags
Context-aware recommendations via discover_skills
Tag-based discovery

📊 Community Insights

Download statistics
Author profiles
Skill ratings (coming soon)
Popular skills (popular_skills)
Recent skills (recent_skills)

🎯 Smart Installation

One-command install from registry
Automatic monorepo subdirectory extraction
Namespace support (@org/skill-name)
Version management

🔄 Easy Updates

Update skills from a terminal via ccpm update <skill-name>

🌐 Multi-Source Support

Primary: CCPM Supabase registry
Fallback: Direct GitHub installation
Custom registry URLs

🏗️ Architecture

Claude Desktop
    ↓ MCP Protocol
claude-skills-mcp
    ↓ CLI Wrapper (execa)
CCPM CLI
    ↓ REST API
Supabase Registry (100+ skills)
    ↓ Git Installer
~/.claude/skills/

Simple & Reliable:

No custom loaders - just wraps existing ccpm CLI
All tools call proven CLI commands
Battle-tested installation logic

🆚 vs. Competitors

vs. `skills-mcp` (Alternative MCP Server)

| Feature | skills-mcp | claude-skills-mcp ✅ | |---------|------------|---------------------| | Discovery | Manual git clone | Searchable registry | | Search | ❌ None | Full-text + filters | | Metadata | Filesystem only | Tags, downloads (ratings planned) | | Analytics | ❌ None | Download tracking | | Quality | No curation | Manual review process | | Install | Manual setup | One-command | | Updates | Manual git pull | Use ccpm update <skill-name> (terminal) | | Monorepo | ❓ Unknown | ✅ Built-in support |

vs. Manual File Management

| Task | Manual | claude-skills-mcp ✅ | |------|--------|---------------------| | Discovery | Google/GitHub search | "Find PDF skills" | | Installation | Clone + copy + fix structure | "Install pdf-processor" | | Updates | Manual git pull in each skill | Use ccpm update <skill-name> (terminal) | | Verification | Check SKILL.md exists | Automatic validation |

🎓 Examples

Search Skills

You: "Find skills for working with images"

Claude: [calls search_skills({ query: "image" })]
        Found 5 results:

        1. image-optimizer (842 downloads)
           Compress and optimize images

        2. image-analyzer (654 downloads)
           Extract metadata and analyze images

        3. screenshot-capture (512 downloads)
           Capture and annotate screenshots

        ...

Discover (Smart Search)

You: "I need to process invoices and export CSV"

Claude: [calls discover_skills({ context: "process invoices and export CSV", limit: 5 })]
        Recommends:
        - invoice-parser
        - csv-exporter
        - pdf-processor

Popular & Recent

You: "Show top 3 this week"

Claude: [calls popular_skills({ limit: 3, timeframe: "week" })]

You: "What's new in the last 7 days?"

Claude: [calls recent_skills({ days: 7, limit: 10 })]

Detailed Info

You: "Tell me about pdf-processor with full details"

Claude: [calls info_skill({ name: "pdf-processor", detailed: true })]
        Shows IDs, publish status, dependencies, timestamps

Install & Configure

You: "Install the image optimizer skill"

Claude: [calls install_skill({ name: "image-optimizer" })]
        ✅ Successfully installed image-optimizer v1.3.0
        📁 Location: ~/.claude/skills/image-optimizer
        ⚠️  Restart Claude Code to activate this skill

Get Skill Details

You: "Tell me more about the image optimizer"

Claude: [calls info_skill({ name: "image-optimizer" })]
        📦 image-optimizer v1.3.0
        👤 Author: daymade
        📥 Downloads: 842
        ⭐ Rating: 4.8/5
        🏷️ Tags: image, optimization, compression

        Description:
        Compresses PNG, JPG, and WebP images while maintaining quality.
        Supports batch processing and multiple compression algorithms.

        GitHub: github.com/daymade/claude-code-skills/image-optimizer

List Installed Skills

You: "What skills do I have?"

Claude: [calls list_skills()]
        You have 8 skills installed:

        User scope (~/.claude/skills/):
        - pdf-processor v1.2.0
        - image-optimizer v1.3.0
        - skill-creator v2.1.0
        - data-analyzer v0.5.0

        Project scope (./.claude/skills/):
        - test-runner v0.8.2
        - code-reviewer v1.0.1
        - api-mocker v0.3.0
        - db-migrator v2.0.0

🔧 Requirements

System

Node.js ≥ 18.0.0
npm or npx (comes with Node.js)

CCPM CLI

This MCP server wraps the CCPM CLI, which must be installed:

# Install CCPM CLI globally
npm install -g @daymade/ccpm

# Or the CLI will auto-install on first use

Claude Desktop

Claude Desktop app installed
MCP support enabled (built-in for recent versions)

🎯 Inspired by Tool Search Tool

This project implements concepts from Anthropic's Tool Search Tool:

| Concept | Anthropic's Approach | Our Implementation | |---------|---------------------|-------------------| | Dynamic discovery | Defer loading tools | Search registry on-demand | | Token efficiency | 85% reduction | Only load queried skills | | Search algorithm | Regex/BM25 | Full-text + ranking | | Metadata | JSON Schema | Rich registry data |

See skills-search-mcp for our Tool Search Tool implementation.

📚 Documentation

QUICK-PUBLISH.md - TL;DR publishing guide
PUBLISHING-GUIDE.md - Complete publishing workflow (300+ lines)
PACKAGE-NAMES-STRATEGY.md - Package naming strategy
SKILLS-ECOSYSTEM-COMPARISON.md - Detailed ecosystem comparison

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md

Development Setup

# Clone repository
git clone https://github.com/deep-reasoning/ccpm.git
cd ccpm

# Install dependencies
pnpm install

# Build MCP server
cd packages/mcp-server
pnpm build

# Test locally
node dist/index.js

Publishing Updates

See PUBLISHING-GUIDE.md for complete workflow.

Quick version:

# Make changes to src/index.ts
vim src/index.ts

# Build
pnpm build

# Publish all 8 packages at once
./publish-all-v2.sh 0.2.0

🐛 Troubleshooting

"CCPM CLI not found"

Solution: Install CCPM CLI

npm install -g @daymade/ccpm

"Skill installation requires restart"

Expected behavior - Claude Code loads skills at startup only.

Solution: Restart Claude Code after installing skills.

"Cannot connect to registry"

Cause: Network issues or registry downtime

Solution: Check connection or try direct GitHub install

ccpm install skill-name --from-github

🔗 Links

Registry Website: https://ccpm.ai
GitHub: https://github.com/deep-reasoning/ccpm
npm Packages:
- https://www.npmjs.com/package/claude-skills-mcp
- https://www.npmjs.com/package/skills-search-mcp
- https://www.npmjs.com/package/mcp-skills
Issues: https://github.com/deep-reasoning/ccpm/issues
MCP Specification: https://spec.modelcontextprotocol.io/

📄 License

MIT © daymade

🙏 Acknowledgments

Anthropic for Claude and MCP protocol
Model Context Protocol team
skills-mcp for inspiration

Made with ❤️ for the Claude Code community

Author: daymade Email: [email protected] Version: 0.2.0 Last Updated: 2025-12-20