Skip to main content
Glama

Skills Registry MCP Server

by kkdub
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables intelligent discovery and management of Claude Skills through semantic search, ratings, favorites, and community curation. Provides tools to search, upload, rate, and organize skills with natural language queries and comprehensive metadata.

  1. Features
    1. Quick Start (Docker)
      1. Prerequisites
      2. 1. Clone and Configure
      3. 2. Start Services
      4. 3. Verify and Import Skills
    2. Usage with NCP
      1. Install NCP
      2. Add Skills Registry MCP
      3. Test MCP Tools
    3. MCP Tools Available
      1. skill_search
      2. skill_get
      3. skill_favorite_add
      4. skill_rate
      5. skill_trending
      6. skill_upload
    4. Development
      1. Project Structure
      2. Local Development
      3. Import Existing Skills
    5. Database Schema
      1. Configuration
        1. Environment Variables
        2. Docker Compose Services
      2. Roadmap
        1. License

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/kkdub/skills-registry-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server