Skills Registry MCP Server

Intelligent discovery and management of Claude Skills using MCP (Model Context Protocol).

Features

🔍 Semantic Search - Find skills using natural language
⭐ Ratings & Reviews - Community-curated skill quality
💾 Favorites - Save your most-used skills
📈 Trending - Discover popular skills
📤 Upload - Add custom skills
🏷️ Categories & Tags - Organized skill library

Quick Start (Docker)

Prerequisites

Docker and Docker Compose
OpenAI API key (for semantic search) or Anthropic API key

1. Clone and Configure

# Copy environment template cp .env.example .env # Edit .env and add your API key (use your preferred editor) # On Mac/Linux: vi .env or code .env # On Windows: notepad .env # Or just echo it directly: echo "OPENAI_API_KEY=sk-your-key-here" >> .env

2. Start Services

# Start PostgreSQL, Redis, and MCP server docker-compose up -d # View logs docker-compose logs -f mcp-server

3. Verify and Import Skills

# Check services are running docker-compose ps # Import skills from GitHub (60+ skills from multiple repos) ./scripts/import_github_skills.sh # Verify import docker-compose exec postgres psql -U skills -d skills_registry -c "SELECT COUNT(*) FROM skills;"

This will import skills from:

Anthropic Official Skills (docx, pdf, pptx, xlsx, theme-factory, etc.)
Obra's Superpowers (test-driven-development, git workflows, etc.)
Composio Community Skills (changelog-generator, content-research-writer, etc.)
Other Community Skills (epub, ffuf, tapestry, etc.)

Usage with NCP

Install NCP

npm install -g @portel/ncp

Add Skills Registry MCP

# Add to NCP configuration ncp add skills-registry npx @your-org/skills-registry-mcp # Or connect to local Docker instance ncp add skills-registry http://localhost:8000

Test MCP Tools

# Search for skills ncp find "pdf extraction" # List categories ncp run skills-registry:skill_list_categories # Get trending skills ncp run skills-registry:skill_trending --params '{"timeframe":"week"}'

MCP Tools Available

`skill_search`

Search for skills using natural language or filters.

{ "query": "create presentations with charts", "category": "documents", "min_rating": 4.0, "limit": 10 }

`skill_get`

Fetch complete skill content and metadata.

{ "skill_id": "pdf-master-v2", "user_id": "user-123" }

`skill_favorite_add`

Add skill to favorites.

{ "skill_id": "docx-advanced", "user_id": "user-123" }

`skill_rate`

Rate a skill 1-5 stars.

{ "skill_id": "xlsx-wizard", "user_id": "user-123", "rating": 5, "review": "Excellent for data analysis!" }

`skill_trending`

Get popular skills.

{ "limit": 10, "timeframe": "week" }

`skill_upload`

Add a custom skill.

{ "name": "API Documentation Generator", "description": "Generate OpenAPI specs from code", "skill_md_content": "# Skill Content Here...", "category": "development", "tags": ["api", "documentation"], "author_id": "user-123", "visibility": "private" }

Development

Project Structure

skills-registry-mcp/ ├── docker-compose.yml # Service orchestration ├── Dockerfile # MCP server container ├── init.sql # Database schema ├── requirements.txt # Python dependencies ├── src/ │ ├── __init__.py │ ├── server.py # FastMCP server │ ├── database.py # PostgreSQL operations │ ├── search.py # Semantic search │ └── models.py # Data models └── skills_storage/ # Local skill files

Local Development

# Install dependencies pip install -r requirements.txt # Set environment variables export DATABASE_URL=postgresql://skills:skills_dev_password@localhost:5432/skills_registry export OPENAI_API_KEY=your-key-here # Run server directly python -m src.server

Import Existing Skills

# Import skills from /mnt/skills/ python scripts/import_skills.py --source /mnt/skills/ --category core

Database Schema

See init.sql for complete schema. Key tables:

skills - Skill metadata and content
skill_ratings - User ratings and reviews
skill_favorites - User favorites
skill_usage - Analytics tracking
skill_stats - Computed statistics view

Configuration

Environment Variables

DATABASE_URL - PostgreSQL connection string
REDIS_URL - Redis connection string
SKILLS_STORAGE_PATH - Local filesystem path for SKILL.md files
OPENAI_API_KEY - For semantic search (optional)
ANTHROPIC_API_KEY - Alternative for semantic search (optional)

Docker Compose Services

postgres - PostgreSQL 15 with pgvector
redis - Redis 7 for caching
mcp-server - FastMCP server

Roadmap

Phase 1: MVP with local search ✅
Phase 2: Semantic search with embeddings ✅
Phase 3: Import existing skills from /mnt/skills/
Phase 4: Cloud-hosted registry option
Phase 5: Web UI for browsing
Phase 6: Skill versioning system

License

MIT

Skills Registry MCP Server

Skills Registry MCP Server

Features

Quick Start (Docker)

Prerequisites

1. Clone and Configure

2. Start Services

3. Verify and Import Skills

Usage with NCP

Install NCP

Add Skills Registry MCP

Test MCP Tools

MCP Tools Available

`skill_search`

`skill_get`

`skill_favorite_add`

`skill_rate`

`skill_trending`

`skill_upload`

Development

Project Structure

Local Development

Import Existing Skills

Database Schema

Configuration

Environment Variables

Docker Compose Services

Roadmap

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API