srprasanna avatar

MCP Skills Server

srprasanna/mcp-skill-hub

This server watches a mounted directory for skill definitions and exposes them through MCP resources and tools. Each skill lives in its own folder with a SKILL.md file containing YAML frontmatter and markdown content. The server hot-reloads when you edit these files, so you can update skills without restarting. You'd use this to maintain a library of reusable prompts, workflows, or domain knowledge that Claude can access on demand. The folder structure is strict: loose files get ignored, everything must be in a dedicated subfolder. Ships as a Docker container or runs via Poetry, configurable through environment variables for reload behavior, debounce timing, and log levels.

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-skills-server:1.0.0
Transport
STDIO
Registry
MCP registry, active

More from srprasanna