MCP Skills Server — MCP-сервер для Claude Code: как настроить
Подключает каталог с пользовательскими навыками к ассистенту через протокол MCP и автоматически обновляет их при редактировании файлов без перезапуска.
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Что делает 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__ парсер тоже отбрасывает.
Какие задачи решает
- подключить локальную коллекцию инструкций к ассистенту через MCP
- обновлять навыки на лету без перезапуска сессии
- структурировать модульные навыки по изолированным папкам
- запустить хаб навыков в Docker-контейнере со смонтированным томом
Примеры запросов агенту
- Покажи список доступных навыков из смонтированного каталога
- Примени инструкции из навыка my-first-skill к текущему файлу
- Проверь, обновился ли навык excel-advanced после изменения SKILL.md
Как установить MCP Skills Server
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCP Skills Server
Как установить MCP Skills Server в Claude Code?
Выполните команду `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`, указав путь к каталогу навыков.
Что делает MCP Skills Server?
Сервер сканирует указанную директорию, загружает навыки из файлов SKILL.md и передаёт их подключённому ИИ-ассистенту как инструменты и ресурсы.
Почему сервер не видит созданный навык?
Файл SKILL.md должен находиться в отдельной подпапке первого уровня. Файлы в корне директории, скрытые папки и системные каталоги сервер пропускает.
