К основному содержанию
плагин

mcp-apps · microsoft — плагин для Claude Code: MCP-инструменты и виджеты

Плагин mcp-apps собирает серверный рантайм MCP-инструмента с JSON-регистрацией и HTML-виджет для его результатов, в том числе без CDN.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install mcp-apps@power-platform-skills
Открыть на GitHub

Что делает mcp-apps

Плагин добавляет в Claude два скилла. /generate-codeful-mcp-tool пишет серверную часть MCP-инструмента парой файлов: <tool-name>.tool.js с рантаймом и <tool-name>.tool.json с метаданными регистрации. /generate-mcp-app-ui собирает один HTML-файл, который рисует результат инструмента.

Схемы живут в JSON-сайдкаре, а не в коде: inputSchema описывает весь объект toolInput, outputSchema — только бизнес-полезную нагрузку, видимую модели. Аннотации заполняются всегда, openWorldHint зафиксирован в false: рантайм изолирован, без импортов, сети, файловой системы, переменных окружения и сохранения состояния между вызовами. Для инструментов поверх Dataverse скилл через PAC CLI находит логические имена таблиц и колонок, а временный RuntimeTypes.ts удаляет после генерации.

Перед сборкой виджета скилл спрашивает, можно ли обращаться к публичным CDN. Ответ «нет» — рекомендуемый путь для MCP Inspector и хостов с жёстким CSP: рантайм MCP Apps и токены темы Fluent вшиваются в HTML, графика рисуется на нативных HTML, CSS, SVG или Canvas. Разрешите CDN, и файл станет меньше, но на хосте со строгой политикой безопасности он не откроется. Попросите виджет в том же запросе к /generate-codeful-mcp-tool, и за один проход получите все три файла.

Какие задачи решает

  • собрать серверный рантайм MCP-инструмента по описанию входов и результата
  • зарегистрировать инструмент через JSON Schema и аннотации, не смешивая их с кодом
  • нарисовать диаграмму по structuredContent в одном HTML-файле
  • узнать логические имена таблиц Dataverse до написания кода
  • сделать виджет, который откроется в MCP Inspector со строгим CSP

Примеры запросов агенту

  • Собери MCP-инструмент через /generate-codeful-mcp-tool: account-summary принимает nameContains и limit до 100, ищет аккаунты и возвращает имена, выручку и статус.
  • Сделай виджет через /generate-mcp-app-ui: столбчатая диаграмма выручки по аккаунтам, CDN не нужны, вот тестовый вывод инструмента.
  • Сгенерируй инструмент и виджет одним запросом к /generate-codeful-mcp-tool, виджет — таблица с сортировкой.

Как установить mcp-apps

Через маркетплейс плагинов

/plugin marketplace add microsoft/power-platform-skills
/plugin install mcp-apps@power-platform-skills

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о mcp-apps

Как установить mcp-apps в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add microsoft/power-platform-skills, затем поставьте плагин: /plugin install mcp-apps@power-platform-skills.

Что делает mcp-apps?

Даёт два скилла: один генерирует рантайм кодого MCP-инструмента и его JSON-сайдкар, второй — HTML-виджет для показа результатов этого инструмента.

Что нужно для инструмента поверх Dataverse?

Доступ к PAC CLI: через него скилл находит логические имена таблиц и колонок и собирает временный файл типов RuntimeTypes.ts, который после генерации удаляется.

Исходный текст

mcp-apps · MIT
# MCP Apps Tool and Widget Generator

Generate JavaScript server runtimes and JSON Schema registration metadata for codeful MCP
tools, plus single-file HTML widgets that visualize their results. Widgets can embed
their runtime for restrictive hosts or use public CDNs when explicitly allowed.

## Installation

### From the marketplace

```bash
/plugin marketplace add microsoft/power-platform-skills
/plugin install mcp-apps@power-platform-skills
```

### From a local clone

```bash
copilot --plugin-dir /path/to/power-platform-skills/plugins/mcp-apps
# or
claude --plugin-dir /path/to/power-platform-skills/plugins/mcp-apps
```

## Skills

### Generate a codeful MCP tool

Run `/generate-codeful-mcp-tool` with the tool's purpose, inputs, expected result, and any
Dataverse data it needs:

```text
/generate-codeful-mcp-tool Create a tool named account-summary.
It accepts nameContains (string) and limit (integer, maximum 100), queries matching
accounts, and returns their names, revenue, and status.
```

For Dataverse-backed tools, the skill uses PAC CLI to discover exact table logical names
and generates a temporary `RuntimeTypes.ts` for verified columns, lookup shapes, and choice
values. The type file is removed after generation. The final output is a matched pair:

- `<tool-name>.tool.js` contains the self-contained runtime.
- `<tool-name>.tool.json` contains the tool registration metadata and MCP tool annotations.

The JavaScript file exports:

```javascript
export async function runTool({ toolInput, dataApi }) {
  // Complete server implementation.
}
```

The runtime is self-contained: no packages, imports, network access, filesystem access,
environment variables, or persistent state.

The JSON sidecar keeps registration concerns out of executable code:

```json
{
  "name": "account-summary",
  "description": "Search accounts by name and return revenue and status summaries.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "outputSchema": {
    "type": "object",
    "properties": {}
  }
}
```

`inputSchema` describes the complete `toolInput` object and its validation constraints.
`outputSchema` describes only the model-visible `structuredContent` business payload. It
does not include conversational `content`, authored `meta`, or runtime `_meta`.
`annotations` always includes `readOnlyHint`, `destructiveHint`, `idempotentHint`, and an
`openWorldHint` fixed to `false` for the constrained codeful runtime.

### Generate an MCP App widget

Run `/generate-mcp-app-ui`, describe the visual, and provide the tool's test output:

```text
/generate-mcp-app-ui Show account revenue as a bar chart.

Here is the tool's test output:
{
  "content": "Found 2 accounts.",
  "structuredContent": {
    "accounts": [
      { "name": "Contoso", "revenue": 1500000 },
      { "name": "Fabrikam", "revenue": 2300000 }
    ]
  },
  "meta": { "preferredView": "bar-chart" }
}
```

The skill asks whether public CDN URLs are allowed. **No CDNs / self-contained** is the
recommended default for MCP Inspector and other hosts with restrictive content security
policies. In that mode, the generated HTML embeds the MCP Apps runtime and Fluent theme
tokens, uses native HTML/CSS/SVG/Canvas for visuals, and has no runtime library downloads.
If CDNs are allowed, the skill retains the smaller CDN-based output.

The UI skill accepts:

- a plain object representing `structuredContent`;
- an authoring envelope with `content`, `structuredContent`, and `meta`; or
- a runtime MCP result with `content`, `structuredContent`, and `_meta`.

`content` and `structuredContent` are visible to the model. Authored `meta` becomes runtime
`_meta`, which is available to the widget but excluded from model context.

### Generate both

Ask `/generate-codeful-mcp-tool` for a widget in the same request. After validating the
paired tool files, it invokes the UI skill with a representative normalized result. The
outputs remain separate: one `.tool.js` server runtime, one `.tool.json` metadata
sidecar, and one `.html` widget.

## Codeful tool result contract

For a simple structured result, return a plain object. The host promotes it to
`structuredContent`:

```javascript
return { records, totalCount: records.length };
```

Use an envelope when the result channels need different visibility:

```javascript
return {
  content: `Found ${records.length} records.`,
  structuredContent: { records },
  meta: { preferredView: "table" },
};
```

The envelope keys are reserved. If business data itself contains `content`,
`structuredContent`, or `meta`, wrap the payload explicitly in `structuredContent`.

## What it produces

- A self-contained `.tool.js` for codeful server logic and a matching `.tool.json`
  registration sidecar.
- Optionally, a single `.html` widget using `@modelcontextprotocol/ext-apps`, either
  embedded with no CDN dependencies or loaded from public CDNs with Fluent UI Web
  Components.

See [`samples/account-summary.tool.js`](samples/account-summary.tool.js) and
[`samples/account-summary.tool.json`](samples/account-summary.tool.json) for a complete
paired tool example, [`samples/flight-status-widget.html`](samples/flight-status-widget.html)
for a read-only widget, and
[`samples/weather-refresh-widget.html`](samples/weather-refresh-widget.html) for an
interactive CDN widget. The marker-based
[`samples/self-contained-widget.template.html`](samples/self-contained-widget.template.html)
shows the source shape used before the bundled runtime is inlined.

## Skill structure

```text
skills/generate-codeful-mcp-tool/SKILL.md       - Server runtime generator
skills/generate-mcp-app-ui/SKILL.md              - Widget generator
references/codeful-tool-host-data-api.d.ts       - Injected server API contract
references/mcp-apps-reference.md                 - MCP Apps result and lifecycle patterns
references/design-guidelines.md                  - Visual design defaults
assets/self-contained/mcp-app-runtime.min.js      - Vendored no-CDN browser runtime
scripts/inline-self-contained-runtime.js          - Deterministic single-file composer
scripts/_vendor-build/                            - Pinned runtime rebuild tooling
samples/account-summary.tool.js                  - Codeful tool example
samples/account-summary.tool.json                - Tool registration metadata example
samples/flight-status-widget.html                - Read-only widget example
samples/weather-refresh-widget.html              - Interactive widget example
samples/self-contained-widget.template.html       - No-CDN source template
```

## Evals

- [`evals/mcp-apps/generate-codeful-mcp-tool/`](../../evals/mcp-apps/generate-codeful-mcp-tool/)
  covers server generation, Dataverse access, result channels, errors, and UI handoff.
- [`evals/mcp-apps/generate-mcp-app-ui/`](../../evals/mcp-apps/generate-mcp-app-ui/)
  covers widget types, result envelopes, private metadata, and type-mismatch stress cases.

Each suite includes `evals.json` and an `eval-runbook.md`.

## Maintaining the self-contained runtime

The no-CDN runtime is committed at
`assets/self-contained/mcp-app-runtime.min.js`. It is generated code; do not edit it by
hand. Its pinned build inputs live under `scripts/_vendor-build/`.

After intentionally changing a dependency version:

```bash
cd plugins/mcp-apps/scripts/_vendor-build
npm ci
npm run build
npm run check
```

Review `PROVENANCE.json` and `THIRD-PARTY-NOTICES.md` with every runtime update. Normal
widget generation does not install packages: it uses the committed bundle through
`scripts/inline-self-contained-runtime.js`. That script also supports `--prepare` to
replace the embedded runtime region with the editable source marker before refining an
existing widget.

## License

See the [LICENSE](../../LICENSE) file for license information.

© Microsoft · MIT · microsoft/power-platform-skills

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →

Сначала — mcp-apps от других авторов.

mcp-apps Anthropic / Model Context Protocol Плагин mcp-apps для Claude Code помогает создать MCP App с нуля, добавить интерфейс к MCP-инструменту или перенести приложение с OpenAI Apps SDK. ★ 3 131звёзд репо power-apps-code-apps официальный Awesome Copilot Community Плагин разворачивает каркас проектов Power Apps Code Apps и подключает агента-эксперта по Dataverse и Power Platform. ★ 41 430звёзд репо generative-ui himself65 Скилл generative-ui для Claude Code задаёт правила дизайн-системы интерактивных HTML- и SVG-виджетов. Показывает графики, диаграммы и калькуляторы вместо текста. CX Codex +1 3 700установок design-mobile-apps designed-by-ai Скилл design-mobile-apps генерирует экраны мобильных приложений через сервис Sleek и помогает перенести готовый макет в React Native или HTML. CX Codex +1 1 500 000установок open-mcp-apps 2nd1st MCP-сервер open-mcp-apps для Claude Code, Codex, Cursor и других хостов. ИИ собирает приложение с интерфейсом один раз, а вы потом открываете его по имени в любом чате. CX Codex +1 ★ 40звёзд репо sleek-design-mobile-apps podo Скилл sleek-design-mobile-apps для Claude Code создаёт экраны мобильных приложений по брифу через Sleek. Затем он может перенести дизайн в React Native или HTML. CX Codex +1 231установок modern-web-guidance GoogleChrome Скилл modern-web-guidance для Claude Code ищет актуальные рекомендации по HTML, CSS и клиентскому JavaScript. Он подключается перед работой над веб-интерфейсом, стилями или логикой в браузере. CX Codex +1 62 500установок

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

Весь набор →
power-automate Открывает доступ к облачным потокам Power Automate через автономный сервер FlowAgent. С его помощью правят логику, диагностируют сбои и переносят потоки между средами. ★ 1 167звёзд репо power-apps-mobile-extension Плагин power-apps-mobile-extension помогает спроектировать и собрать нативный контрол Power Apps Mobile в .ppmplugin и создать парный PCF-контрол для Canvas app. ★ 1 167звёзд репо mobile-app Скилл mobile-app для Claude, который собирает мобильное приложение Power Apps на Expo и React Native: план, экраны, нативные функции и коннекторы. ★ 1 167звёзд репо code-apps-preview Плагин code-apps-preview помогает создавать и развёртывать код-приложения Power Apps на базе React и Vite с готовыми коннекторами платформы. ★ 1 167звёзд репо canvas-apps Плагин canvas-apps связывает Claude Code с открытым приложением Power Apps Canvas. Агент сможет создавать и менять экраны, элементы управления и формулы. ★ 1 167звёзд репо pcf Сборка, тестирование, деплой и аудит компонентов PCF для Power Apps. Помогает создавать контролы для model-driven и canvas-приложений. ★ 1 167звёзд репо model-apps Плагин model-apps собирает модельные приложения Power Apps и генеративные страницы из описания обычным языком — от таблиц Dataverse до кода на React. ★ 1 167звёзд репо power-pages Плагин Microsoft для Claude с 39 скиллами: каркас сайта Power Pages, локальная правка, деплой, активация и браузерные тесты. ★ 1 167звёзд репо

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

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