mcp-app-builder — скилл для Claude Code: что делает и как установить
Скилл mcp-app-builder помогает создавать и обновлять MCP-приложения с интерактивным UI на базе фреймворка Skybridge. Пригодится при сборке расширений для ChatGPT и Claude.
MIT 208 установок ★ 2 199 обновлён 2026-10-23
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a claude-codeЧто делает mcp-app-builder
Скилл ведёт разработку MCP-серверов с визуальным интерфейсом по шагам. Главный рабочий документ здесь — SPEC.md: если этого файла в проекте ещё нет, процесс начинается строго с фазы проектирования через discover.md. Приложения строятся на общей поверхности: человек взаимодействует с интерфейсом, а модель считывает состояние этого же экрана.
Внутри собраны инструкции под ключевые этапы: копирование шаблона, локальный dev-сервер, авторизация через OAuth и правила CSP. Также скилл помогает обновить проект со старых версий Skybridge (< 0.36.x и ветки 1.x на 2.x) и подготовить эвалы для проверки вызова инструментов. Без готового SPEC.md переходить к написанию кода архитектура скилла прямо запрещает.
Какие задачи решает
- спроектировать MCP-сервер с кастомным интерфейсом под требования
SPEC.md - настроить синхронизацию UI-состояния и контекста модели
- подключить OAuth-авторизацию и правила CSP для внешних доменов
- подготовить эвалы для проверки вызова инструментов моделью
- обновить проект со старых версий Skybridge на ветку 2.x
Примеры запросов агенту
- Помоги составить SPEC.md для нового MCP-приложения на Skybridge
- Настрой авторизацию через OAuth и политики CSP для нашего MCP-сервера
- Обнови проект с Skybridge 1.x на версию 2.0.0
Как установить mcp-app-builder
1Через Skills CLI (Vercel)
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-app-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-app-builder/
1Через Skills CLI (Vercel)
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a codex2Вручную: положить файлы
.agents/skills/mcp-app-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a cursor2Вручную: положить файлы
.cursor/skills/mcp-app-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install alpic-ai/skybridge skills/mcp-app-builder2Вручную: положить файлы
.github/skills/mcp-app-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/alpic-ai/skybridge --path skills/mcp-app-builderВручную: положить файлы
.devin/skills/mcp-app-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add alpic-ai/skybridge --skill mcp-app-builder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-app-builder
Как установить mcp-app-builder в Claude Code?
Выполните в терминале команду npx skills add alpic-ai/skybridge --skill mcp-app-builder -a claude-code.
Что делает скилл mcp-app-builder?
Он ведёт разработчика через полный цикл создания MCP-приложений на фреймворке Skybridge — от составления спецификации до деплоя через Alpic.
С чего начинается разработка нового MCP-приложения?
С создания файла SPEC.md по руководству discover.md. Пока спецификации нет, скилл не разрешает переходить к архитектуре и коду.
Исходный текст
SKILL.md · MIT
--- name: mcp-app-builder description: | Guide developers through creating and updating MCP Apps. Covers the full lifecycle: brainstorming ideas against UX guidelines, bootstrapping projects, implementing tools/views, debugging, running dev servers, deploying and connecting apps to ChatGPT. Use when a user wants to create or update a MCP App, MCP server or use the Skybridge framework. --- # Creating MCP Apps Those are conversational experiences that extend AI assistants through tools and custom UI views. They're built as MCP servers invoked during conversations. ⚠️ The app is consumed by two users at once: the **human** and the **AI Assistant LLM**. They collaborate through the view—the human interacts with it, the LLM sees its state. Internalize this before writing code: the view is your shared surface. SPEC.md keeps track of the app's requirements and design decisions. Keep it up to date as you work on the app. **No SPEC.md?** → Read [discover.md](references/discover.md) first. Nothing else until SPEC.md exists. **SPEC.md exists?** → Read SPEC.md, then follow [architecture.md](references/architecture.md) to design the change. Update SPEC.md, then read the relevant Implementation references below before writing code. **Migrating from Skybridge `< 0.36.x`?** → Read [migrate-to-v1.md](references/migrate-to-v1.md) first. Users may reference `skybridge >= 0.36.x` as v1. **Migrating from Skybridge `1.x` to `2.x`?** → Fetch the [v2.0.0 release notes](https://github.com/alpic-ai/skybridge/releases/tag/v2.0.0) first and follow them. **Building an ecommerce app?** → Read [ecommerce.md](references/ecommerce.md) first. ## Setup 1. **Copy template** → [copy-template.md](references/copy-template.md): when starting a new project with ready SPEC.md 2. **Run locally** → [run-locally.md](references/run-locally.md): when ready to test, need dev server or ChatGPT/Claude connection 3. **Evals** → [evals.md](references/evals.md): when checking that a real model reaches the right tools from natural prompts, in a test ## Architecture Design or evolve UX flows and API shape → [architecture.md](references/architecture.md) ## Implementation - **Fetch and render data** → [fetch-and-render-data.md](references/fetch-and-render-data.md): when implementing server handlers and view data fetching - **State and context** → [state-and-context.md](references/state-and-context.md): when persisting view UI state and updating LLM context - **Prompt LLM** → [prompt-llm.md](references/prompt-llm.md): when view needs to trigger LLM response - **UI guidelines** → [ui-guidelines.md](references/ui-guidelines.md): display modes, layout constraints, theme, device, and locale - **External links** → [open-external-links.md](references/open-external-links.md): when redirecting to external URLs or setting "open in app" target - **Download file** → [download-file.md](references/download-file.md): when saving content to the user's filesystem - **OAuth** → [oauth.md](references/oauth.md): when tools need user authentication to access user-specific data - **CSP** → [csp.md](references/csp.md): when declaring allowed domains for fetch, assets, redirects, or iframes ## Deploy - **Ship to production** → [deploy.md](references/deploy.md): when ready to deploy via Alpic - **Publish to ChatGPT/Claude Directories** → [publish.md](references/publish.md): when ready to submit for review Full API docs: [https://docs.skybridge.tech/api-reference.md](https://docs.skybridge.tech/api-reference.md) Release notes & changelog: [https://skybridge.tech/changelog.md](https://skybridge.tech/changelog.md)
© alpic-ai · MIT · alpic-ai/skybridge