Skill Ninja MCP Server 🥷
An MCP (Model Context Protocol) server for searching, installing, and managing AI Agent Skills.
Works with MCP-compatible clients like Claude Desktop, Cursor, and VS Code.
Installation
npm install -g skill-ninja-mcp-server
Or run it directly with npx:
npx skill-ninja-mcp-server
Configuration
Claude Desktop
~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"skill-ninja": {
"command": "npx",
"args": ["skill-ninja-mcp-server"]
}
}
}
VS Code (mcp.json)
%APPDATA%\Code\User\mcp.json:
{
"servers": {
"skill-ninja": {
"command": "npx",
"args": ["skill-ninja-mcp-server"]
}
}
}
Environment Variables
Security
Workspace-mutating tools only operate inside trusted workspace roots.
- By default, the server trusts the current working directory only when it looks like a project root.
- To allow other locations, set the
SKILL_NINJA_TRUSTED_WORKSPACESenvironment variable to one or more trusted roots separated by your OS path delimiter. - Requests outside trusted roots are rejected before any read, write, or delete occurs.
- GitHub API and raw content fetches use a bounded timeout so network failures return control instead of hanging the MCP server indefinitely.
Duplicate Skill Names
- Search and recommendation results include the source name for each skill.
- If multiple sources publish the same skill name, pass the optional
sourcefield toskillNinja_installorskillNinja_localize. - Installed skill listings include the recorded source, and the server refuses to overwrite an installed skill with the same name from a different source.
- If a partial skill name matches multiple different skills, the install, localize, and uninstall flows now stop and ask for the exact skill name instead of picking the first match.
Tools
skillNinja_install tries to fetch the original SKILL.md from the source repository. If the source file cannot be resolved or downloaded, it installs a minimal file generated from the local index and reports that fallback in the result.
Usage Examples
"Find skills for Azure work"
-> skillNinja_search
"Install the webapp-testing skill from GitHub Awesome Copilot"
-> skillNinja_install with skillName="webapp-testing" and source="github-awesome-copilot"
"Install test"
-> refine to the exact skill name first, for example "test-driven-development"
"Search GitHub for MCP skills"
-> skillNinja_webSearch
Development
git clone https://github.com/aktsmm/skill-ninja-mcp-server
cd skill-ninja-mcp-server
npm install
npm test
npm run release:verify
License
CC BY-NC-SA 4.0 — see LICENSE.
