# @ag-ui/mcp-middleware 中文文档

规范地址：https://npmcn.com/package/%40ag-ui/mcp-middleware/

版本：0\.0\.2
npm 元数据更新时间：2026-09-11T20:03:00.370Z
中文译文更新时间：2026-11-05T17:07:11.988Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：80.9 kB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：rxjs 7\.8\.1，@ag-ui/client \>=0\.0\.40
- 首次发布：2026-06-01T11:17:42.034Z
- 最新版本发布：2026-09-11T20:03:00.017Z
- 近 30 天下载量：1112404（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

连接代理运行到一个或多个的 AG-UI 中间软件 [MCP 磁共振](https://modelcontextprotocol.io/) 服务器。 它列出每个服务器的工具,将它们注入运行中,执行生成的工具调用服务器侧,并循环代理,直到没有 MCP 工具调用为止

## 安装

```sh
npm install @ag-ui/mcp-middleware
```

也可以使用：`pnpm add @ag-ui/mcp-middleware`、`yarn add @ag-ui/mcp-middleware`、`bun add @ag-ui/mcp-middleware`

## README

# MCP 中间软件

连接代理运行到一个或多个的 AG-UI 中间软件 [MCP 磁共振](https://modelcontextprotocol.io/) 服务器。 它列出每个服务器的工具,将它们注入运行中,执行 生成工具调用服务器侧,并循环代理直到没有 MCP 工具调用 ——均作为单一连续运行提供给消费者.

## 使用量

```ts
import { MCPMiddleware } from "@ag-ui/mcp-middleware";

agent.use(
  new MCPMiddleware([
    {
      type: "http",
      url: "https://example.com/mcp",
      serverId: "example",
      headers: { Authorization: "Bearer <token>" },
    },
  ]),
);
```

## 行为

-   **工具喷入.** 服务器上报的每个工具都会暴露在代理中 名称间隔为 `mcp__{serverId}__{tool}` (环卫至 `[a-zA-Z0-9_-]`, (中文(简体) ), 切换到64个字符,并切换到一个 `_N` 打开后缀 碰撞). `serverId` 默认为 `server{index}` 当省略时。 列名 每个中间软件实例发生一次并被缓存.
-   **执行循环.** 当完成的运行离开 MCP 工具打开时 中间软件执行它们(并行),发出 a `TOOL_CALL_RESULT` 每个人, 并且——如果没有其他东西是开放的——以附加的结果开始另一次运行. 如果非MCP工具的调用仍然开放(例如前端工具),则停止和手 转到前端 不针对注入的MCP工具的工具呼叫是 从来没有碰过.
-   **单跑介绍.** 整个多点穿透的循环 看起来像一个 运行到消费者:第一个 `RUN_STARTED` 已转发,继续 `RUN_STARTED` 事件被压制,一个终端 `RUN_FINISHED` 实值 只有在循环停止时被冲走 .
-   **出逃后卫.** `maxIterations` (默认) `32`) 上限数 工具执行回合。 值被夹入正整数.

## 配置

```ts
interface MCPClientConfig {
  type: "http" | "sse";
  url: string;
  serverId?: string;
  headers?: Record<string, string>;
}

interface MCPMiddlewareOptions {
  maxIterations?: number; // default 32
}
```

通过构建每个请求的中间软件支持每个请求的认证 `headers` 通过运输机的外出MCP请求盖章 `requestInit`。 。 。 .

> **SSE 备注 :** 联 合 国 `sse` 运输, `headers` 仅适用于 POST 频道; SSE 事件流使用 `eventSourceInit`更倾向于 `http` (可流的)运输,当头必须覆盖所有交通.

## 常见问题

### @ag-ui/mcp-middleware 是什么？

连接代理运行到一个或多个的 AG-UI 中间软件 MCP 磁共振 服务器。 它列出每个服务器的工具,将它们注入运行中,执行生成的工具调用服务器侧,并循环代理,直到没有 MCP 工具调用为止

### 如何安装 @ag-ui/mcp-middleware？

在项目目录运行 npm install @ag-ui/mcp-middleware，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（7\.8\.1）、@ag-ui/client（\>=0\.0\.40）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ag-ui/mcp-middleware 支持 TypeScript 吗？

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

### @ag-ui/mcp-middleware 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ag-ui/mcp-middleware 可以商用吗？

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

### @ag-ui/mcp-middleware 的下载量有多少？

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

### @ag-ui/mcp-middleware 还在维护吗？

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