# @frontmcp/adapters 中文文档

规范地址：https://npmcn.com/package/%40frontmcp/adapters/

版本：1\.12\.2
npm 元数据更新时间：2026-11-14T21:11:34.898Z
中文译文更新时间：2026-11-15T15:12:07.493Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40frontmcp/adapters
原文对照：https://npmcn.com/package/%40frontmcp/adapters/?lang=original
项目主页：https://frontmcp.dev/reference/adapters/openapi
源码仓库：https://github.com/agentfront/frontmcp

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

- 包体积（解压后）：765 kB，106 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：7 个
- peer 依赖：@frontmcp/lazy-zod 1\.12\.2
- 首次发布：2025-11-05T02:06:39.013Z
- 最新版本发布：2026-11-14T21:11:34.526Z
- 近 30 天下载量：10589（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：127（近 12 个月 119 个）

## 中文简介

FrontMCP适配器:将 OpenAPI spec 转换为 MCP 工具( OpenapiAdapter)

## 安装

```sh
npm install @frontmcp/adapters
```

也可以使用：`pnpm add @frontmcp/adapters`、`yarn add @frontmcp/adapters`、`bun add @frontmcp/adapters`

## README

# @ frontmcp/ 适应器

FrontMCP服务器的适配器. 一个适配器在服务器启动时从另一个来源建立工具. 这个软件包 `OpenapiAdapter`,它读取了一个 REST API 的 OpenAPI 3 描述,并且每次操作都会给您的应用一个工具,这样您就可以将您已经拥有的 API 放在模型前,而不为每个端点写一个工具 .

[![npm](https://img.shields.io/npm/v/@frontmcp/adapters.svg)](https://www.npmjs.com/package/@frontmcp/adapters) [![License](https://img.shields.io/npm/l/@frontmcp/adapters.svg)](https://github.com/agentfront/frontmcp/blob/main/LICENSE)

## 安装

```bash
npm install @frontmcp/adapters
```

在 FrontMCP 应用程序中使用:它取决于 `@frontmcp/sdk`,所以两者保持同一版本. 它需要节点.js 24或后.

## 使用量

列出 `OpenapiAdapter.init()` 在应用程序 `adapters`数字 :

```ts
import { OpenapiAdapter } from '@frontmcp/adapters';
import { App } from '@frontmcp/sdk';

@App({
  id: 'petstore',
  name: 'Pet Store',
  adapters: [
    OpenapiAdapter.init({
      name: 'petstore',
      url: 'https://petstore3.swagger.io/api/v3/openapi.json',
      baseUrl: 'https://petstore3.swagger.io/api/v3',
    }),
  ],
})
export class PetStoreApp {}
```

所需的选项 :

| 选项 | 类型 | 说明 |
| --- | --- | --- |
| `name` | `string` | 命名适配器。 在这个过程中它必须是独一无二的,并且前缀一个其名称与另一个工具相冲突的工具. |
| `baseUrl` | `string` | API所在之处. 每个操作的路径都附着在其上, 它胜过Spec's `servers`。 。 。 . |
| `spec` **或者说** `url` | `object` 或者说 `string` | OpenAPI 3.0 或 3.1 文档作为对象,或 `http:` 或者说 `https:` URL 从服务器启动时下载它 . |

每个工具在发出请求之前先检查其针对操作参数和机体计划的论点. 其他选项设置全权证书`staticAuth`, (中文(简体) ), `authProviderMapper`, (中文(简体) ), `securityResolver`,过滤和重命名操作(`generateOptions`, (中文(简体) ), `toolTransforms`),在服务器上填写输入(`inputTransforms`),重塑反应(`dataTransforms`),并在服务器运行时重读光谱(`polling`) (中文(简体) ). [OpenAPI 适配器](https://frontmcp.dev/reference/adapters/openapi) 文档每个选项.

解析光谱并生成工具由 [`mcp-from-openapi`](https://www.npmjs.com/package/mcp-from-openapi)。 。 。 .

### 入境点

| 导入 | 它有什么东西 |
| --- | --- |
| `@frontmcp/adapters` | `OpenapiAdapter`, (中文(简体) ), `OpenApiSpecPoller`,以及 OpenAPI 帮助和类型. |
| `@frontmcp/adapters/openapi` | 相同的 OpenAPI 导出, 与 `OpenapiAdapter` 作为默认导出. |
| `@frontmcp/adapters/skills` | 技能捆绑源和捆绑店 [`@frontmcp/plugin-skilled-openapi`](https://www.npmjs.com/package/@frontmcp/plugin-skilled-openapi)。 。 。 . |

根和(或) `/openapi` 各入口单独建起,每个入口都有自己的副本 `OpenapiAdapter`,所以从其中之一 导入整个应用程序.

## 文档

-   [OpenAPI 适配器](https://frontmcp.dev/reference/adapters/openapi): 每一个选项, 证书, 转换和光谱投票
-   [环绕 OpenAPI 服务](https://frontmcp.dev/learn/wrapping-an-openapi-service):分步骤指南
-   [OpenAPI 的宠物存储](https://frontmcp.dev/examples/pet-store-from-openapi):一个完整的API包裹并适合一个模型
-   [`@Adapter`](https://frontmcp.dev/reference/sdk/adapter): 自己写一个适配器

## 相关软件包

-   [`@frontmcp/sdk`](https://www.npmjs.com/package/@frontmcp/sdk):适配器插入的框架.
-   [`@frontmcp/plugin-skilled-openapi`](https://www.npmjs.com/package/@frontmcp/plugin-skilled-openapi): 对于一个 API 太大而不能列为工具.
-   [`@frontmcp/testing`](https://www.npmjs.com/package/@frontmcp/testing):适配器生成的工具的端到端测试.
-   [`mcp-from-openapi`](https://www.npmjs.com/package/mcp-from-openapi): 下面的 OpenAPI 到 MCP 转换器.

## 捐款

资料来源: [`libs/adapters`](https://github.com/agentfront/frontmcp/tree/main/libs/adapters)欢迎提出问题和拉动请求;见 [捐款额](https://github.com/agentfront/frontmcp/blob/main/CONTRIBUTING.md)。 。 。 .

## 许可证

阿帕奇2.0 (英语). 见 [自由主义](https://github.com/agentfront/frontmcp/blob/main/LICENSE)。 。 。 .

## 常见问题

### @frontmcp/adapters 是什么？

FrontMCP适配器:将 OpenAPI spec 转换为 MCP 工具\( OpenapiAdapter\)

### 如何安装 @frontmcp/adapters？

在项目目录运行 npm install @frontmcp/adapters，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@frontmcp/lazy-zod（1\.12\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @frontmcp/adapters 支持 TypeScript 吗？

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

### @frontmcp/adapters 支持 ESM 还是 CommonJS？

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

### @frontmcp/adapters 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @frontmcp/adapters 可以商用吗？

@frontmcp/adapters 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @frontmcp/adapters 的下载量有多少？

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

### @frontmcp/adapters 还在维护吗？

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