mcp-server-skills — скилл для Claude Code: MCP-серверы на Next.js
Шаблон для сборки MCP-серверов в Next.js: общие Zod-схемы, лёгкий route и серверные экшены для веб-UI.
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a claude-codeЧто делает mcp-server-skills
Скилл задаёт структуру папок Next.js App Router под MCP-сервер. Один обработчик живёт в app/api/[transport]/route.ts, логика и Zod-схемы — в lib/*, а серверные экшены в app/actions/mcp-actions.ts переиспользуют ту же логику для веб-интерфейса и тестов.
Смысл в том, чтобы route.ts оставался тонким: он только подключает createMcpHandler из пакета mcp-handler и регистрирует инструменты через server.tool, беря имя, описание и схему из общего файла. Ответы приводят к единой форме { success, result | error }, поэтому MCP-инструменты и UI не расходятся. Транспорты HTTP и SSE работают через /api/[transport]; для stdio нужна отдельная точка входа. Параметр basePath в конфиге обработчика должен совпадать с путём папки.
Для проверки из Claude Desktop скилл показывает конфиг с mcp-remote, который проксирует http://localhost:3000/api/mcp. Без запущенного локального сервера на этом порту мост подключаться не будет. Ещё скилл советует не держать состояние в глобальных переменных — это ломается на serverless-хостинге вроде Vercel, где при необходимости настраивают maxDuration и runtime.
Какие задачи решает
- описать Zod-схему инструмента один раз и переиспользовать её в MCP и в UI
- оставить
route.tsтонким, вынеся логику вlib/* - проверить ответы MCP-инструментов через серверные экшены в веб-интерфейсе
- подключить HTTP-транспорт MCP к Claude Desktop через
mcp-remote - привести ответы инструментов и веб-UI к одной форме
{ success, result | error }
Примеры запросов агенту
- Собери MCP-сервер на Next.js по этому скиллу: вынеси Zod-схемы в
lib/dice.tsи подключиcreateMcpHandlerвapp/api/[transport]/route.ts. - Добавь инструмент
roll_diceи серверный экшен, который вызывает ту же логику для веб-теста. - Настрой конфиг Claude Desktop с
mcp-remoteнаhttp://localhost:3000/api/mcp.
Как установить mcp-server-skills
1Через Skills CLI (Vercel)
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-server-skills/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-server-skills/
1Через Skills CLI (Vercel)
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a codex2Вручную: положить файлы
.agents/skills/mcp-server-skills/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a cursor2Вручную: положить файлы
.cursor/skills/mcp-server-skills/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gocallum/nextjs16-agent-skills mcp-server-skills2Вручную: положить файлы
.github/skills/mcp-server-skills/SKILL.md1Через Skills CLI (Vercel)
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a gemini-cli2Командой платформы
gemini skills install https://github.com/gocallum/nextjs16-agent-skills --path skills/mcp-server-skillsВручную: положить файлы
.devin/skills/mcp-server-skills/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-server-skills
Как установить mcp-server-skills в Claude Code?
Выполните npx skills add gocallum/nextjs16-agent-skills --skill mcp-server-skills -a claude-code. Файл скилла окажется по пути ~/.claude/skills/mcp-server-skills/SKILL.md.
Что делает mcp-server-skills?
Описывает шаблон MCP-сервера на Next.js: общие Zod-схемы и логика в lib/*, тонкий обработчик в app/api/[transport]/route.ts, серверные экшены для веб-UI.
Чем этот скилл отличается от обычной настройки MCP-сервера?
Он держит схемы и логику в одном месте, поэтому MCP-инструменты и серверные экшены используют один и тот же код, а не дублируют его.
