К основному содержанию
скилл CX Codex

mcp-builder · dkyazzentwatwa — скилл для Claude Code: проектирование MCP-серверов

Скилл mcp-builder для планирования и разработки MCP-серверов с инструментами, схемами, обработкой ошибок и тестированием. Пригодится при создании новых интеграций или рефакторинге существующих.

Apache-2.0 198 установок ★ 136 обновлён 2026-04-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dkyazzentwatwa/chatgpt-skills --skill mcp-builder -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/mcp-builder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mcp-builder/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

mcp-builder официальный anthropics Скилл mcp-builder для Claude Code пошагово направляет агента при разработке серверов Model Context Protocol на TypeScript или Python. Помогает проектировать схемы инструментов, подключать API и тестировать транспорт. CX Codex +1 130 949установок mcp-builder jezweb Скилл mcp-builder проводит от брифа до задеплоенного MCP-сервера на Python с FastMCP: описываете инструменты, получаете код, тесты и чек-лист перед выкладкой. CX Codex +1 1 400установок mcp-builder waybarrios Скилл mcp-builder для Claude Code и Codex руководит разработкой серверов Model Context Protocol. Направляет агента при интеграции внешних сервисов на Python или TypeScript. CX Codex +1 106установок mcp-builder shareAI-lab Скилл mcp-builder для Claude Code и Codex, который ведёт агента по созданию MCP-серверов. Включается, когда нужно дать агенту доступ к внешним API, базе данных или файлам через стандартизованный протокол. CX Codex +1 ★ 80 707звёзд репо mcp-builder mcp-use Скилл mcp-builder помогает создавать MCP-серверы на базе mcp-use: от заготовки проекта до локальной проверки и деплоя. CX Codex +1 735установок track17 tristanmanchester Скилл track17 для Claude Code регистрирует и отслеживает посылки через 17TRACK API, сохраняет события доставки и принимает вебхуки. Интегрирует трекинг посылок через 17TRACK в агента. CX Codex +1 104установок build-mcp-server официальный Anthropic Скилл build-mcp-server помогает спроектировать MCP-сервер для Claude Code: уточняет задачу, выбирает способ развёртывания и схему инструментов. CX Codex +1 6 711установок Vivaldo Product Discovery vivaldoeuropes MCP-сервер Vivaldo Product Discovery для поиска и просмотра товаров европейского магазина Vivaldo прямо из IDE. Подключается к Claude Code, Cursor, GitHub Copilot и другим редакторам с поддержкой MCP. CX Codex +1 7 716установок cisco-meraki membrane Скилл для работы с облачной платформой Cisco Meraki через терминал. Позволяет список организации, сети, устройства, VLAN и другие ресурсы; создавать и обновлять конфигурации без входа в веб-интерфейс. CX Codex +1 246установок shopify membrane Скилл для работы с данными Shopify прямо из редактора: управляй товарами, заказами и клиентами через CLI Membrane. Нужен аккаунт Membrane (бесплатный уровень поддерживается). CX Codex +1 240установок runway-dev-recipes runwayml Скилл runway-dev-recipes подключает готовые многошаговые воркфлоу Runway Dev API — Recipes — для генерации изображений и видео через SDK. CX Codex +1 217установок

Из того же набора12

Весь набор →
document-converter-suite Скилл document-converter-suite для Claude Code и других платформ: конвертирует PDF, Office-файлы, markdown, HTML и таблицы в редактируемые форматы. Вытаскивает данные из документа или собирает его заново. CX Codex +1 495установок image-enhancement-suite Скилл image-enhancement-suite для Claude Code обрабатывает изображения по одной или пакетно: удаляет фон, собирает спрайты и извлекает палитры в чате с агентом. CX Codex +1 308установок svg-precision-skill Скилл svg-precision-skill для Claude Code, Codex, Cursor, Copilot и других платформ: строит SVG из явных координат и размеров, проверяет результат перед выдачей. Используется для иконок, диаграмм, графиков, UI-моков и технических чертежей. CX Codex +1 306установок qr-code-generator Скилл qr-code-generator создаёт одиночные и пакетные QR-коды для печати и веба, проверяет ссылки и добавляет UTM-метки. CX Codex +1 252установок data-storyteller Скилл data-storyteller превращает CSV и таблицы в текстовые отчёты с графиками, аудитом качества и статистикой. Подходит для разведочного анализа и презентаций. CX Codex +1 241установок media-toolkit Скилл media-toolkit для Claude Code обрезает, конвертирует и анализирует аудио и видео Python-скриптами. Обрабатывает субтитры, тайм-лапс, GIF и пакетные операции. CX Codex +1 184установок skill-creator Скилл skill-creator для создания новых скиллов: генерирует структуру папок, SKILL.md, метаданные агентов и проверяет всё перед упаковкой. CX Codex +1 167установок geo-toolkit Набор инструментов для работы с географическими данными: парсинг адресов, конвертация форматов, геокодирование и расчёт расстояний. Пригодится, если нужно подготовить координаты к картографированию или привести адреса в порядок. CX Codex +1 139установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой