# @developmentseed/mcp-view 中文文档

规范地址：https://npmcn.com/package/%40developmentseed/mcp-view/

版本：0\.14\.0
npm 元数据更新时间：2026-11-11T17:22:58.253Z
中文译文更新时间：2026-11-12T02:57:24.415Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40developmentseed/mcp-view
原文对照：https://npmcn.com/package/%40developmentseed/mcp-view/?lang=original
项目主页：https://github.com/developmentseed/mcp-toolsets-runtime#readme
源码仓库：https://github.com/developmentseed/mcp-toolsets-runtime

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.8 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-07-30T08:22:13.752Z
- 最新版本发布：2026-11-11T17:22:57.776Z
- 近 30 天下载量：3160（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

MCP Apps UI 视图的侧桥: ui/ \* 后Message协议作为三个小功能(onData / sendMessage / callTool).

## 安装

```sh
npm install @developmentseed/mcp-view
```

也可以使用：`pnpm add @developmentseed/mcp-view`、`yarn add @developmentseed/mcp-view`、`bun add @developmentseed/mcp-view`

## README

# @ 开发种子/ mcp- 视图

风景桥 [MCP 应用程序](https://github.com/modelcontextprotocol/ext-apps) UI 视图: `ui/*` 后Message协议作为三个小函数.

一个 MCP 工具可以传送一个 UI 视图—— 服务器曝光的 HTML 捆绑 `ui://<toolset>/<id>` 资源,主机在聊天中进行内入 而不是生的JSON。 捆绑在沙箱里 和主机交谈 结束 `ui/*` JSON - RPC - 后传Message. 此软件包包 [官方 SDK](https://www.npmjs.com/package/@modelcontextprotocol/ext-apps) 所以你的视野就不用知道 它落在哪个主机了.

```bash
npm install @developmentseed/mcp-view
```

## 使用

```ts
import { onData, sendMessage } from "@developmentseed/mcp-view";

// The tool's structuredContent, delivered by the host once the tool has run.
onData((data) => render(data));

// A user turn back into the conversation, so the model calls the next tool.
button.onclick = () => sendMessage("clip this to the Severn catchment");
```

`onData` 登记您的处理器并连接到主机; `sendMessage` 员额 如用户输入了信息.

### 从视图中调用工具

当视图比工具的结果更需要绘制自己时——边界 在模型的上下文,一个表格的下一页——它可以 调用工具本身 :

```ts
import { callTool } from "@developmentseed/mcp-view";

try {
  const result = await callTool("places_get", {
    place_id: data.place_id,
    include: ["boundary"],
  });
  if (result.isError) showProblem(result.content);
  else drawOutline(result.structuredContent);
} catch (error) {
  // The host refused or could not deliver the call.
}
```

这是MCP Apps的 `tools/call`在服务器主机的代理下,视图来了 从. 结果只回到了观点:没有进入对话 没有模型转弯, 这是区别于 `sendMessage`。东道主 只运行工具 `_meta.ui.visibility` 包含 `"app"`; 一个工具 如spec说.

`callTool` 与主机解析 `CallToolResult`,包括一个 `isError: true`作为SDK的 `callServerTool` 是的,所以检查 `isError` 在此之前 画画. 它拒绝当主机回答错误时.

期间可选择识别您的观点 `ui/initialize` 握个手,叫它 第一次选举之前 `onData`, (中文(简体) ), `sendMessage` 或者说 `callTool`数字 :

```ts
import { configure } from "@developmentseed/mcp-view";

configure({ name: "dataset-gallery", version: "1.2.0" });
```

## 主机

同样的捆绑在任何MCP Apps主机——克洛德.ai,ChatGPT, Goose, VS 代码——和网络客户端捆绑在一起 [`mcp-toolsets-runtime`](https://github.com/developmentseed/mcp-toolsets-runtime), (中文(简体) ), 它执行本协议的主机端.

观点是渐进增强:工具的 `message` 和结构化内容 仍然站在自己的一个普通的 MCP客户端 不能让他们,所以 传送一个视图从不会使工具在任何地方无法使用.

## 为观众服务

构建和提供捆绑是服务器的工作,而不是这个包的工作. 若为 你用着 `mcp-toolsets-runtime`,声明 `VIEWS = {tool_name: view_id}` 内 您的工具箱和船运 已建成的捆绑在 `<package>/views/<view_id>.html` 看到了吗 [协商](https://github.com/developmentseed/mcp-toolsets-runtime/blob/main/docs/CONSUMING.md)。 。 。 .

## 页:1

-   仅限无害环境管理,包含类型脚本.
-   与 Python 一起锁定版本 `mcp-toolsets-runtime` 分发,从 同一个仓库.

MIT 发展种子

## 常见问题

### @developmentseed/mcp-view 是什么？

MCP Apps UI 视图的侧桥: ui/ \* 后Message协议作为三个小功能\(onData / sendMessage / callTool\)\.

### 如何安装 @developmentseed/mcp-view？

在项目目录运行 npm install @developmentseed/mcp-view，或使用 pnpm add / yarn add / bun add。

### @developmentseed/mcp-view 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @developmentseed/mcp-view 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @developmentseed/mcp-view 可以商用吗？

@developmentseed/mcp-view 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @developmentseed/mcp-view 的下载量有多少？

根据 npm 官方下载统计，@developmentseed/mcp-view 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,160 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @developmentseed/mcp-view 还在维护吗？

最新版本 0\.14\.0 发布于 2026/11/12（今天）；至今共发布 54 个版本，其中过去 12 个月发布了 54 个；首次发布于 2026/07/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。