srprasanna avatar

MCP Skills Server

srprasanna/mcp-skill-hub

A hot-reloading skill manager that watches a mounted directory for SKILL.md files and exposes them through MCP resources and tools. Each skill lives in its own folder with frontmatter metadata (name, description, version, dependencies, examples) and Markdown content. The server enforces folder structure validation, skips hidden or system directories, and reloads automatically when files change with configurable debounce. Ships as a Docker image or runs via Poetry, connects to Claude Desktop through stdio transport, and surfaces skills as MCP resources you can query and load dynamically. Reach for this when you want to organize reusable prompts or techniques as a file system collection that Claude can browse and apply without restarting.

GitHub stars
8
tools
4
transport
STDIO
env vars
3
last updated
Oct 25, 2025

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

search_skillsSearch for skills by query, category, tag, or complexity.

Search for skills by query, category, tag, or complexity.

No parameter schema in public metadata yet.

reload_skillsManually trigger a reload of all skills from the directory.

Manually trigger a reload of all skills from the directory.

No parameter schema in public metadata yet.

get_skill_infoGet metadata for a specific skill without loading full content.

Get metadata for a specific skill without loading full content.

No parameter schema in public metadata yet.

list_skill_foldersList all valid skill folders found in the skills directory.

List all valid skill folders found in the skills directory.

No parameter schema in public metadata yet.

Sponsors

Configuration

MCP_SKILLS_DIRdefault: /skills

Root directory containing skill folders

MCP_SKILLS_HOT_RELOADdefault: true

Enable automatic reloading when SKILL.md files change

MCP_SKILLS_LOG_LEVELdefault: INFO

Logging verbosity: DEBUG, INFO, WARNING, ERROR, CRITICAL

Readme

MCP Skills Server

Python 3.13+ Poetry License: MIT MCP Registry Docker Docker Pulls

A production-ready Model Context Protocol (MCP) server that dynamically loads and exposes skills from a mounted volume with hot-reloading support.

📦 Available on MCP Registry - Install with one command!

Features


View the full README on GitHub

Details

Repository
github.com/srprasanna/mcp-skill-hub
Website
srprasanna.github.io/mcp-skill-hub
Package
docker.io/srprasanna/mcp-skill-hub:1.0.0
Transport
STDIO
Registry
MCP registry, active

More from srprasanna