Skill Ninja MCP Server 🥷

日本語版 README

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.

Features

• 🔍 Search skills by keyword from 140+ pre-indexed skills
• 📥 Install skills to workspace (.github/skills/)
• 📋 List installed skills
• 💡 Get personalized recommendations based on workspace analysis
• 🌐 Search GitHub for new skills
• ➕ Add new skill sources

Installation

npm install -g skill-ninja-mcp-server

Or run 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

| Variable | Description | Default | | ----------------------- | ---------------------------------- | ---------------- | | GITHUB_TOKEN | GitHub API token (for rate limits) | None | | SKILL_NINJA_INDEX_DIR | Index storage directory | ~/.skill-ninja | | LANG | Language setting (e.g., ja_JP) | System default |

Available Tools

| Tool | Description | | ------------------------ | --------------------------------- | | skillNinja_search | Search skills by keyword | | skillNinja_install | Install a skill to workspace | | skillNinja_uninstall | Uninstall a skill | | skillNinja_list | List installed skills | | skillNinja_recommend | Get popular skill recommendations | | skillNinja_updateIndex | Update the skill index | | skillNinja_webSearch | Search skills on GitHub | | skillNinja_addSource | Add a new skill source | | skillNinja_localize | Translate skill descriptions |

Usage Examples

💬 "Find Azure-related skills"
   → Calls skillNinja_search

💬 "Install the bicep-mcp skill"
   → Installs via skillNinja_install

💬 "Search GitHub for MCP servers"
   → Searches via skillNinja_webSearch

Development

# Clone
git clone https://github.com/aktsmm/skill-ninja-mcp-server
cd skill-ninja-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT