MCP Skill Server

Provides deterministic, deployable skill execution with a fixed entry point and on-demand loading for MCP-powered agents.

python

1

GitHub Stars

python

Language

2 months ago

First Indexed

3 weeks 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": {
    "jcc-ne-mcp-skill-server": {
      "command": "uvx",
      "args": [
        "mcp-skill-server",
        "serve",
        "/path/to/my/skills"
      ]
    }
  }
}

You can run MCP Skill Server locally to discover, describe, and execute skills with a fixed entry point, making skills deterministic and ready for production deployment while keeping feedback loops tight during development.

How to use

You connect an MCP client to the server to manage and execute skills. You can list available skills, fetch detailed information about a skill’s commands and parameters, and run a skill with specific arguments. The server exposes a consistent interface across agents, so you get the same description, parameter names, and help text no matter which client you use. Develop a skill locally, validate its behavior, then reuse the exact same entry point when you deploy to production.

How to install

Prerequisites: you need Python installed on your machine. You also should have an MCP client capable of communicating with the server (for example Claude Code, Cursor, or a compatible tool). Follow the steps to install, run, and connect to your skills directory.

Install from PyPI (recommended): you install the MCP Skill Server using the Python package manager.

uv pip install mcp-skill-server

Or install from source and synchronize dependencies, then run the server.

# From source
git clone https://github.com/jcc-ne/mcp-skill-server
cd mcp-skill-server
uv sync
# Run the server against your skills directory
uvx mcp-skill-server serve /path/to/my/skills

Connecting a client to the server

Add the server as an MCP endpoint in your editor or agent client. The most common local setup uses the following command structure to start the server and point it at your skills folder.

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": ["mcp-skill-server", "serve", "/path/to/my/skills"]
    }
  }
}

Available tools

list_skills

List all available skills on the server.

get_skill

Retrieve detailed information about a specific skill, including commands and parameters.

run_skill

Execute a skill with provided parameters and capture the output.

refresh_skills

Reload skills after changes to ensure the latest interface is exposed to clients.