aktsmm/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.
Installation
Or run it directly with npx:
Configuration
Claude Desktop
~/.claude/claude_desktop_config.json:
VS Code (mcp.json)
%APPDATA%\Code\User\mcp.json:
Environment Variables
| Variable | Description | Default |
| -------------------------------- | --------------------------------------------------------- | ------------------------------------- |
| GITHUB_TOKEN | GitHub API token for higher rate limits | none |
| SKILL_NINJA_INDEX_DIR | Skill index storage directory | ~/.skill-ninja |
| SKILL_NINJA_TRUSTED_WORKSPACES | Trusted workspace roots allowed for read/write operations | auto-detect current project root only |
| LANG | Output language, for example ja_JP | system default |
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_WORKSPACES environment 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 source field to skillNinja_install or skillNinja_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
| Tool | Description |
| ------------------------ | ---------------------------------------------------------- |
| skillNinja_search | Search the local skill index by keyword |
| skillNinja_install | Install a skill into a trusted workspace |
| skillNinja_uninstall | Remove an installed skill from a trusted workspace |
| skillNinja_list | List installed skills in a trusted workspace |
| skillNinja_recommend | Recommend skills based on workspace contents |