# MCP Skills Server

Подключает каталог с пользовательскими навыками к ассистенту через протокол MCP и автоматически обновляет их при редактировании файлов без перезапуска.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Автор: srprasanna
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/srprasanna/mcp-skill-hub
- Обновлён: 2025-10-29
- HTML: https://affpapa.org/nevibecode/mcp/mcp-skills-server

## Что делает

Сервер раздаёт агентам инструкции и навыки из локальной директории. Каждое умение оформляется в виде файла `SKILL.md` с YAML-шапкой для имени и описания, а также основной частью в Markdown. Сервер считывает эти файлы, валидирует структуру каталогов и регистрирует их в окружении агента как ресурсы и инструменты MCP.

В систему встроен мониторинг файловой системы с горячей перезагрузкой: при сохранении правок в `SKILL.md` изменения подтягиваются автоматически с задержкой в 0.5 секунды. Запустить сервис можно через Docker-образ `docker.io/srprasanna/mcp-skill-hub:1.0.0` или локально с помощью интерпретатора Python 3.13+ и пакетного менеджера Poetry 1.7+.

Файлы `SKILL.md` в корне каталога сервер полностью игнорирует: каждый навык обязан лежать строго в отдельной подпапке первого уровня вложенности. Скрытые папки с точкой в начале и системные каталоги вроде `node_modules` или `__pycache__` парсер тоже отбрасывает.

## Требования
- Нужно: Docker
- Переменные окружения: `MCP_SKILLS_DIR`, `MCP_SKILLS_HOT_RELOAD`, `MCP_SKILLS_LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MCP_SKILLS_DIR=<MCP_SKILLS_DIR> --env MCP_SKILLS_HOT_RELOAD=<MCP_SKILLS_HOT_RELOAD> --env MCP_SKILLS_LOG_LEVEL=<MCP_SKILLS_LOG_LEVEL> --transport stdio mcp-skills-server -- docker run -i --rm -e MCP_SKILLS_DIR -e MCP_SKILLS_HOT_RELOAD -e MCP_SKILLS_LOG_LEVEL docker.io/srprasanna/mcp-skill-hub:1.0.0
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-skills-server --env MCP_SKILLS_DIR=<MCP_SKILLS_DIR> --env MCP_SKILLS_HOT_RELOAD=<MCP_SKILLS_HOT_RELOAD> --env MCP_SKILLS_LOG_LEVEL=<MCP_SKILLS_LOG_LEVEL> -- docker run -i --rm -e MCP_SKILLS_DIR -e MCP_SKILLS_HOT_RELOAD -e MCP_SKILLS_LOG_LEVEL docker.io/srprasanna/mcp-skill-hub:1.0.0
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-skills-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_SKILLS_DIR",
                "-e",
                "MCP_SKILLS_HOT_RELOAD",
                "-e",
                "MCP_SKILLS_LOG_LEVEL",
                "docker.io/srprasanna/mcp-skill-hub:1.0.0"
            ],
            "env": {
                "MCP_SKILLS_DIR": "<MCP_SKILLS_DIR>",
                "MCP_SKILLS_HOT_RELOAD": "<MCP_SKILLS_HOT_RELOAD>",
                "MCP_SKILLS_LOG_LEVEL": "<MCP_SKILLS_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-skills-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MCP_SKILLS_DIR",
                "-e",
                "MCP_SKILLS_HOT_RELOAD",
                "-e",
                "MCP_SKILLS_LOG_LEVEL",
                "docker.io/srprasanna/mcp-skill-hub:1.0.0"
            ],
            "env": {
                "MCP_SKILLS_DIR": "<MCP_SKILLS_DIR>",
                "MCP_SKILLS_HOT_RELOAD": "<MCP_SKILLS_HOT_RELOAD>",
                "MCP_SKILLS_LOG_LEVEL": "<MCP_SKILLS_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MCP_SKILLS_DIR=<MCP_SKILLS_DIR> -e MCP_SKILLS_HOT_RELOAD=<MCP_SKILLS_HOT_RELOAD> -e MCP_SKILLS_LOG_LEVEL=<MCP_SKILLS_LOG_LEVEL> mcp-skills-server docker run -i --rm -e MCP_SKILLS_DIR -e MCP_SKILLS_HOT_RELOAD -e MCP_SKILLS_LOG_LEVEL docker.io/srprasanna/mcp-skill-hub:1.0.0
```
Вместо <…> подставьте свои значения

## Когда брать
- подключить локальную коллекцию инструкций к ассистенту через MCP
- обновлять навыки на лету без перезапуска сессии
- структурировать модульные навыки по изолированным папкам
- запустить хаб навыков в Docker-контейнере со смонтированным томом

## Примеры запросов агенту
- Покажи список доступных навыков из смонтированного каталога
- Примени инструкции из навыка my-first-skill к текущему файлу
- Проверь, обновился ли навык excel-advanced после изменения SKILL.md

## Похожие
- [hmr](https://affpapa.org/nevibecode/mcp/hmr.md) — MCP-сервер · ★ 59
- [extension-development](https://affpapa.org/nevibecode/skills/extension-development.md) — скилл · ★ 1979
- [makepad-2.0-app-structure](https://affpapa.org/nevibecode/skills/makepad-20-app-structure.md) — скилл · ★ 751
- [mtp-hot-reload](https://affpapa.org/nevibecode/skills/mtp-hot-reload.md) — скилл · 3400 установок
- [ce-polish](https://affpapa.org/nevibecode/skills/ce-polish.md) — скилл · 1100 установок
- [bun-hot-reloading](https://affpapa.org/nevibecode/skills/bun-hot-reloading.md) — скилл · 395 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md