Skill Mcp Server

by ephemeraldew

279 downloads Not rated yet

GitHub

About

Skill MCP Server is a standard [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that bridges Claude Skills to any AI agent that supports MCP.

Explore

- 🛠️ Highly Standardized: Strictly follows MCP protocol
- 🌍 Universal Compatibility: Not tied to any vendor, works with all MCP-compatible AI clients
- ⚡ Zero-Code Integration: Helps agents without native Skill support quickly access the Skill ecosystem
- 📦 Fully Compatible: Supports SKILL.md format and scripts/, references/ resource directories
- 📂 Workspace Isolation: Supports --workspace parameter to specify where Skill output files are stored
- 🔄 Hot Reload: Add new skills without restarting the server
- 🔒 Secure by Design: Path validation, sandboxed file operations

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Skill Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

From the repository

Step-by-step instructions for the AI agent...

Recommended: Use uvx to run without manual installation.


Add Skill MCP Server to your MCP client configuration. All MCP-compatible clients use the same configuration format:

Using uvx (recommended, no installation needed):

json { "mcpServers": { "skill-server": { "command": "uvx", "args": [ "skill-mcp-server", "--skills-dir", "/path/to/your/skills", "--workspace", "/path/to/workspace" ] } } } ``



Using local installation:

json
{
  "mcpServers": {
    "skill-server": {
      "command": "python",
      "args": [
        "-m", "skill_mcp_server",
        "--skills-dir", "/path/to/your/skills",
        "--workspace", "/path/to/workspace"
      ]
    }
  }
}



Configuration file locations:
- Claude Desktop:

claude_desktop_config.json

 (location varies by OS)
- Claude Code:

~/.claude.json


- Other MCP clients: Refer to your client's documentation

Parameter Explanation:

-

--skills-dir

: Core parameter. Set to the root directory containing all Skill folders you want your agent to use.
-

--workspace

: Important parameter. Specifies where Skill execution output files (code, reports, etc.) are saved.

When users request deployment, follow these steps: 1. Useskill_resourceto read the deployment template. 2. Modify local configuration files. 3. Callskill_scriptto execute the deployment script.``

uv pip install -e ".[dev]"

`skill`

Load a skill to get detailed instructions for a specific task. No skills are currently available.

`list_skills`

List all available skills with their names and descriptions. Use this to discover what skills are available before loading one.

`skill_resource`

Read a resource file from a skill's directory. Use this tool after loading a skill to read referenced files like templates, examples, or reference documentation. The resource_path should be relative to the skill's base directory (e.g., 'assets/template.md', 'references/api_reference.md').

`skill_script`

Execute a script from a skill's scripts/ directory. Use this tool to run Python (.py), Shell (.sh/.bash), JavaScript (.js), or TypeScript (.ts) scripts bundled with a skill. Scripts are executed in the workspace directory.

`file_read`

Read a file from the workspace directory. Use this tool to read files generated by skills or modified by the user.

`file_write`

Create or overwrite a file in the workspace. Use this tool when a skill needs to generate output files.

`file_edit`

Edit an existing file in the workspace using search and replace. The old_string must exist in the file and should be unique.

Once connected, your AI agent can use the following tools:

1. 🔍 list_skills: List all available skills
2. 📚 skill: Load a specific skill to get detailed instructions from its SKILL.md
3. 📄 skill_resource: Read reference documents or templates from skill packages
4. ▶️ skill_script: Execute scripts bundled with skills in a secure environment
5. 📖 file_read: Read files from the specified workspace
6. ✍️ file_write: Write files to the specified workspace
7. ✏️ file_edit: Edit existing files in the workspace

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "skill mcp server": {
            "skill-server": {
                "command": "uvx",
                "args": [
                    "skill-mcp-server",
                    "--skills-dir",
                    "/path/to/your/skills",
                    "--workspace",
                    "/path/to/workspace"
                ]
            }
        }
    }
}

McpServers

{
    "skill-server": {
        "command": "uvx",
        "args": [
            "skill-mcp-server",
            "--skills-dir",
            "/path/to/your/skills",
            "--workspace",
            "/path/to/workspace"
        ]
    }
}

Turn any AI agent into a specialist — just drop in a skill folder. <a href="#what-is-skill-mcp-server">📖 What is it?</a> • <a href="#why-choose-skill-mcp-server">🌟 Why Choose It?</a> • <a href="#features">✨ Features</a> • <a href="#quick-start">🚀 Quick Start</a> • <a href="#creating-skills">📝 Creating Skills</a> • <a href="#documentation">📚 Documentation</a>

📖 What is Skill MCP Server?

Skill MCP Server is a standard Model Context Protocol (MCP) server that bridges Claude Skills to any AI agent that supports MCP. --- Previously, Claude Skills were mainly used in Anthropic's official tools. If your AI application doesn't support Skills, you'd have to implement your own parsing and execution logic, which is a hassle. With this project, you can simply configure it and let any MCP-compatible Agent use standard Skill files directly.

💡 Core Concepts

- 🔌 MCP (Model Context Protocol): Think of it as a "USB interface" for AI. As long as your AI assistant supports this interface, it can connect to various tools and services. - 📦 Claude Skills: Think of them as "skill packages" for AI. They're not just documentation — they include instructions (SKILL.md), accompanying scripts (Python/JS), and reference materials. Skill MCP Server is a "converter" that helps various agents use the Skill ecosystem, enabling plug-and-play functionality.

🌟 Why Choose Skill MCP Server?

If your Agent doesn't support Skills yet, this project can help you quickly integrate: | Dimension | Natively Supported Agents (e.g., Claude Code) | Other Agents (with this project) | |-----------|------------------------------------------------|----------------------------------| | Access Barrier | Deep integration, usually non-portable | Low barrier, standard MCP protocol | | Development Burden | Official implementation complete | Zero code, no need to build Skill parser | | Flexibility | Tied to specific clients | Cross-platform, works with any MCP-compatible agent | | Feature Parity | Full script, resource & file stream support | Perfect alignment, same dynamic execution & resource access |

✨ Features

- 🛠️ Highly Standardized: Strictly follows MCP protocol - 🌍 Universal Compatibility: Not tied to any vendor, works with all MCP-compatible AI clients - ⚡ Zero-Code Integration: Helps agents without native Skill support quickly access the Skill ecosystem - 📦 Fully Compatible: Supports SKILL.md format and scripts/, references/ resource directories - 📂 Workspace Isolation: Supports --workspace parameter to specify where Skill output files are stored - 🔄 Hot Reload: Add new skills without restarting the server - 🔒 Secure by Design: Path validation, sandboxed file operations

🚀 Quick Start

Recommended: Use uvx to run without manual installation.

📥 Installation

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

skill

list_skills

skill_resource

skill_script

file_read

file_write

file_edit

Claude Desktop / Cursor

McpServers

📖 What is Skill MCP Server?

💡 Core Concepts

🌟 Why Choose Skill MCP Server?

✨ Features

🚀 Quick Start

📥 Installation

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

`skill`

`list_skills`

`skill_resource`

`skill_script`

`file_read`

`file_write`

`file_edit`