MCP Skills Server

A production-ready MCP server that dynamically loads skills from a mounted directory with hot-reloading and full MCP protocol support.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "srprasanna-mcp-skill-hub": {
      "command": "poetry",
      "args": [
        "run",
        "mcp-skills"
      ],
      "env": {
        "MCP_SKILLS_DIR": "YOUR_PATH_TO_SKILLS",
        "MCP_SKILLS_LOG_LEVEL": "INFO"
      }
    }
  }
}

You run a production-ready MCP server that dynamically loads skills from a mounted directory, supports hot-reloading, and exposes a complete MCP-compatible set of resources and tools. Mount your skills directory into the server, start it, and your client can browse, query, and execute skills on demand with automatic reloads when you update SKILL.md files.

How to use

You can interact with this MCP server from an MCP client by pointing the client to a running server instance and using the built-in tools to discover, reload, and inspect skills. The server exposes a catalog of skills and individual skill content, and it supports hot-reloading so changes to SKILL.md files are picked up without restarting the server. To leverage skills in workflows, start the server with your preferred method and ensure the skills directory is correctly mounted.

How to install

Prerequisites: you need Python 3.13+ and Poetry 1.7+ installed on your system. Docker is optional if you want to run the server in a container.

# Clone the project repository
git clone https://github.com/srprasanna/mcp-skill-hub.git
cd mcp-skill-hub

# Install dependencies
poetry install

# Verify installation
poetry run mcp-skills --help

Running locally with Poetry

Set your skills directory and start the server using Poetry. This runs the MCP Skills server in a local development style.

# Set the skills directory to your local path
export MCP_SKILLS_DIR=/path/to/your/skills

# Run the server
poetry run mcp-skills

Running with Docker

Run the server in a container with your skills directory mounted. This keeps skill content isolated and portable.

docker run -i --rm \
  -v ~/claude-skills:/skills:ro \
  mcp-skill-hub

Running with Docker Compose

If you prefer Docker Compose, adjust the compose file to mount your skills directory and start the service.

Integrating with Claude Desktop

Configure Claude Desktop to use the MCP server by pointing to the container or the Poetry command, depending on your setup. Ensure the skills directory path is accessible from the chosen environment.

Available tools

search_skills

Search for skills by query, category, tag, or complexity to quickly locate relevant content.

reload_skills

Manually trigger a reload of all skills from the directory to reflect recent changes.

get_skill_info

Retrieve metadata for a specific skill without loading full content.

list_skill_folders

List all valid skill folders found within the skills directory to verify structure.