ext-apps

环境要求

• Node.js 20 及以上版本
• 使用 npm 安装依赖（README 仅给出 npm 命令）
• MCP 基础 SDK 包为 ext-apps 的 ^2.0.0 peer 依赖
• 如需使用 Claude Code 技能，需已安装 Claude Code 插件市场环境

安装与启动步骤

1. 1确认 Node 版本

   README 明确要求 Node.js 20+，先检查本机版本，低于 20 需先升级 Node。

   node -v

   复制

2. 2安装 View/宿主依赖

   构建可内嵌 UI（View）或聊天宿主时安装 ext-apps、client 与 zod 三项依赖。

   npm install -S @modelcontextprotocol/ext-apps \
     @modelcontextprotocol/client@^2.0.0 \
     zod@^4.2.0

   复制

3. 3安装 MCP 服务端依赖

   服务端需额外安装 server；使用 HTTP 传输时再加 node 与 express 适配器。

   npm install -S @modelcontextprotocol/ext-apps \
     @modelcontextprotocol/client@^2.0.0 \
     @modelcontextprotocol/server@^2.0.0 \
     @modelcontextprotocol/node@^2.0.0 \
     @modelcontextprotocol/express@^2.0.0 \
     zod@^4.2.0

   复制

4. 4安装 Claude Code 技能

   在 Claude Code 中通过插件市场命令安装 mcp-apps 技能包，获得建应用与迁移能力。

   /plugin marketplace add modelcontextprotocol/ext-apps
   /plugin install mcp-apps@modelcontextprotocol-ext-apps

   复制

5. 5验证技能已安装

   向 AI 代理询问它有哪些技能，列表中应出现 README 给出的四个技能名。

6. 6按 Quickstart 建首个应用

   README 建议新手从官方 Quickstart 指南开始，逐步构建第一个 MCP App。

如何确认成功

在代理中提问“What skills do you have?”，列表出现 create-mcp-app、migrate-oai-app、add-app-to-server、convert-web-app 即安装成功。

常见问题

注意事项

• README 只提供 npm 安装方式，未给出 yarn/pnpm 命令，请勿自行替换包管理器。
• 示例运行部分（Running the Examples）的具体命令未在节选中给出，需查阅仓库原文与 Quickstart 指南。
• 本项目是规范与 SDK 仓库，不提供独立可执行服务，安装后需自行在代码中集成。
• 中文文档与 API 详情以官网 apps.extensions.modelcontextprotocol.io 为准。