mcp-maintainer — скилл для Claude Code: обслуживание MCP-сервера
Скилл mcp-maintainer помогает обслуживать локальный MCP-сервер: проверять его состояние, менять инструменты и разбираться с проблемами запуска. Пригодится при работе с MCP в этом репозитории.
MIT ★ 1 198 обновлён 2026-10-23
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a claude-codeЧто делает mcp-maintainer
Скилл задаёт порядок обслуживания локального MCP-сервера. Сначала проверьте доступность API панели через /api/health, затем изучите нужные модули в mcp/src/tools/domains/. Изменения защитных проверок сверяйте с mcp/src/policy/tool-guards.ts.
После правок запустите npm run mcp:typecheck и npm run mcp:build. Внутри есть ссылки на карту доменов инструментов и инструкцию по эксплуатации: references/tool-domain-map.md и references/operations-runbook.md.
Проверки адресов должны оставаться ограниченными loopback, а изменяющие и разрушающие действия — требовать явных флагов. Протокольные данные нельзя выводить в stdout; нарушение этого правила затрагивает защитные ограничения сервера.
Какие задачи решает
- проверить доступность API панели MCP
- найти модуль инструмента для правки
- сохранить защитные проверки при изменении политик
- проверить типы и собрать MCP-сервер
Примеры запросов агенту
- Проверь доступность API панели через
/api/healthи найди нужный модуль инструмента. - Измени защитную проверку в
mcp/src/policy/tool-guards.ts, сохранив ограничения для loopback. - После правок выполни
npm run mcp:typecheckиnpm run mcp:build.
Как установить mcp-maintainer
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-maintainer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-maintainer/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a codex2Вручную: положить файлы
.agents/skills/mcp-maintainer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a cursor2Вручную: положить файлы
.cursor/skills/mcp-maintainer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor .agents/skills/mcp-maintainer2Вручную: положить файлы
.github/skills/mcp-maintainer/SKILL.md1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a gemini-cli2Командой платформы
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .agents/skills/mcp-maintainerВручную: положить файлы
.devin/skills/mcp-maintainer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-maintainer
Как установить mcp-maintainer в Claude Code?
Выполните npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-maintainer -a claude-code. Файл скилла находится по пути ~/.claude/skills/mcp-maintainer/SKILL.md.
Что делает mcp-maintainer?
Он помогает обслуживать локальный MCP-сервер в репозитории: проверять API панели, находить модули инструментов и валидировать изменения.
Какие проверки нужно сохранить при работе с MCP-сервером?
Оставьте проверки целевых адресов только для loopback. Изменяющие и разрушающие инструменты должны требовать явных флагов, а протокольные данные нельзя выводить в stdout.
Исходный текст
SKILL.md · MIT
--- name: mcp-maintainer description: Operate and maintain the local MCP server for this repository. Use for MCP tool updates, policy-guard changes, host configuration, and MCP runtime troubleshooting. --- # MCP Maintainer Skill ## Workflow - Confirm dashboard API availability (`/api/health`). - Inspect affected MCP domain modules under `mcp/src/tools/domains/`. - Preserve safety gates in `mcp/src/policy/tool-guards.ts`. - Validate with `npm run mcp:typecheck` and `npm run mcp:build`. ## Safety rules - Keep loopback-only target checks enabled. - Keep mutating and destructive tools behind explicit flags. - Do not log protocol data to stdout. ## References - `references/tool-domain-map.md` - `references/operations-runbook.md`
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor