mcp-builder · dkyazzentwatwa — скилл для Claude Code: проектирование MCP-серверов
Скилл mcp-builder для планирования и разработки MCP-серверов с инструментами, схемами, обработкой ошибок и тестированием. Пригодится при создании новых интеграций или рефакторинге существующих.
Apache-2.0 198 установок ★ 136 обновлён 2026-04-08
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-codeЧто делает mcp-builder
Скилл учит агента строить MCP-серверы вокруг рабочих процессов пользователя, а не вокруг сырых эндпоинтов API. Процесс начинается с анализа документации целевого API и выделения сценариев, которые агент должен выполнить полностью. Затем проектируется компактный набор инструментов с чёткими идентификаторами и понятными ошибками.
Внутри скилла — ссылки на лучшие практики дизайна, примеры реализации на Python и TypeScript, а также вспомогательные скрипты для проверки подключений и оценки сервера. Особое внимание к инфраструктуре: аутентификация, вспомогательные функции для запросов, пагинация, усечение больших данных и форматирование.
Скилл ориентирован на ограниченный контекст агента и большие наборы данных: возвращаемые результаты должны быть лаконичными и содержательными, сообщения об ошибках — исправительными, а идентификаторы — читаемыми.
Какие задачи решает
- Спроектировать инструменты MCP-сервера, привязанные к рабочим процессам агента
- Написать схемы инструментов и документацию, понятные для автоматизации
- Обработать ошибки API так, чтобы агент понял, что делать дальше
- Оценить готовый MCP-сервер на реальных задачах перед развёртыванием
- Организовать общую инфраструктуру: аутентификацию, форматирование, пагинацию
Примеры запросов агенту
- Спроектируй MCP-сервер для Stripe: выдели рабочие процессы агента и набор инструментов
- Напиши schemaсы инструментов MCP-сервера для работы с файлами на S3 с понятными ошибками
- Оцени готовый MCP-сервер на задачах: агент должен создать платёж и отправить уведомление
Как установить mcp-builder
1Через Skills CLI (Vercel)
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-builder/
1Через Skills CLI (Vercel)
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a codex2Вручную: положить файлы
.agents/skills/mcp-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a cursor2Вручную: положить файлы
.cursor/skills/mcp-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dkyazzentwatwa/chatgpt-skills mcp-builder2Вручную: положить файлы
.github/skills/mcp-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/dkyazzentwatwa/chatgpt-skills --path mcp-builderВручную: положить файлы
.devin/skills/mcp-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-builder
Как установить mcp-builder в Claude Code?
Выполни команду npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code, затем открой ~/.claude/skills/mcp-builder/SKILL.md.
Что делает mcp-builder?
Скилл помогает проектировать MCP-серверы, ориентируясь на рабочие процессы агента, а не на сырые API. Внутри — шаблоны для схем инструментов, обработки ошибок, аутентификации и тестирования серверов.
Какие языки поддерживает скилл?
Скилл включает примеры реализации на Python и TypeScript, с ссылками на лучшие практики для обоих языков.
Исходный текст
SKILL.md · Apache-2.0
--- name: mcp-builder description: Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation. Use when creating or refactoring MCP integrations. --- # MCP Builder Build MCP servers around user workflows, not raw API endpoints. ## Workflow 1. Read the target API docs and identify the workflows an agent must complete end to end. 2. Design a small tool surface with high-signal outputs, clear identifiers, and actionable errors. 3. Implement shared infrastructure first: auth, request helpers, pagination, truncation, and formatting. 4. Add tool schemas and docstrings that make correct usage obvious. 5. Evaluate the server with realistic tasks before expanding scope. ## Principles - Prefer workflow tools over thin endpoint wrappers. - Return concise, high-signal responses by default. - Use human-readable identifiers whenever possible. - Make error messages corrective: tell the agent what to try next. - Design for limited context and large datasets. ## Resources - `references/mcp_best_practices.md` for design principles that apply to every server. - `references/python_mcp_server.md` for Python implementation patterns. - `references/node_mcp_server.md` for TypeScript implementation patterns. - `scripts/connections.py` and `scripts/evaluation.py` as repo-local helpers. ## Deliverables - A concrete tool inventory tied to user workflows. - Strict input/output schemas. - Evaluation prompts or scripts that confirm the server is usable by an agent.
© dkyazzentwatwa · Apache-2.0 · dkyazzentwatwa/chatgpt-skills
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — mcp-builder от других авторов.