# @2kw/ai-mcp-server 中文文档

规范地址：https://npmcn.com/package/%402kw/ai-mcp-server/

版本：8\.2\.0
npm 元数据更新时间：2026-11-08T20:12:46.752Z
中文译文更新时间：2026-11-08T20:15:08.872Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%402kw/ai-mcp-server
原文对照：https://npmcn.com/package/%402kw/ai-mcp-server/?lang=original
项目主页：https://2kw.ai/

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

- 包体积（解压后）：387 kB，77 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.20\.8
- 运行依赖：2 个
- 首次发布：2026-04-26T17:40:14.733Z
- 最新版本发布：2026-11-08T20:12:46.577Z
- 近 30 天下载量：10495（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：180（近 12 个月 180 个）

## 中文简介

2kw.ai的MCP服务器——由欧盟主办的AI平台:OpenAI兼容LLM网关,由计划驱动的文件提取,抄写,具有知识基础的代理,成本可观察性. 199个工具用于克洛德代码,Cursor,和Windsurf.

## 安装

```sh
npm install @2kw/ai-mcp-server
```

也可以使用：`pnpm add @2kw/ai-mcp-server`、`yarn add @2kw/ai-mcp-server`、`bun add @2kw/ai-mcp-server`

## README

# 2kw.ai MCP (英语). 服务器

一个 [MCP(示范背景议定书)](https://modelcontextprotocol.io/) 用于服务器 [2kw.ai (英语)](https://2kw.ai/) ——由欧盟主办的AI集成平台. 它可以让Claude Code、Cursor和Windsurf等AI编码助理直接访问 [OpenAI 兼容 LLM 网关](https://2kw.ai/gateway), (中文(简体) ), [策略驱动的文档提取](https://2kw.ai/extraction)录音记录,有知识库的定制代理,以及 [成本可观察性](https://2kw.ai/observability) - 199个工具,直接从你的编辑.

已安装的典型提示 : _"从这张PDF发票中摘录行项目"_, (中文(简体) ), _制作定购单计划 并用这些样本测试_, (中文(简体) ), _"记录这个电话录音"_, (中文(简体) ), _"我们这周的撤离交通费是多少?"_。 。 。 .

## 安装

### 克劳德代码

```bash
claude mcp add 2kw --env AI_2KW_API_KEY=sk_your_api_key -- npx -y @2kw/ai-mcp-server
```

### 光标

添加为 `.cursor/mcp.json` 在您的工程根中 :

```json
{
  "mcpServers": {
    "2kw": {
      "command": "npx",
      "args": ["-y", "@2kw/ai-mcp-server"],
      "env": {
        "AI_2KW_API_KEY": "sk_your_api_key"
      }
    }
  }
}
```

### 风起浪起

将同一块添加到 `.windsurf/mcp.json`。任何 MCP 兼容客户端都使用此配置模式 。 服务器默认情况下会讲 stdio , 当可流的 HTTP 时 `MCP_TRANSPORT=http`。 。 。 .

从您的 API 密钥中获取 [2kw.ai 仪表板](https://2kw.ai/) ——有偿计划从7天免费审判开始.

## 环境变量

| 变量 | 需求 | 默认 | 说明 |
| --- | --- | --- | --- |
| `AI_2KW_API_KEY` | 对 | —— 说 | 2kw.ai平台的 API 密钥( 遗留别名 : `BACKBONE_API_KEY`(中文(简体) ) |
| `AI_2KW_BASE_URL` | 没有 | 2kw.ai云 API | 指向自备部署(后勤别名: `BACKBONE_BASE_URL`(中文(简体) ) |
| `AI_2KW_MEMORY` | 没有 | 关 | `true` 让代理通过 `2kw_create_response` 财务报告和审定财务报表 `2kw_decide_agent_approvals` 选择使用代理内存( n)`X-Backbone-Memory: enabled`(中文(简体) ) |
| `MCP_TRANSPORT` | 没有 | `stdio` | 运输模式 : `stdio` 或者说 `http` |
| `MCP_HTTP_PORT` | 没有 | `3100` | HTTP 运输端口 |

## 可用工具

| 类别 | 你的助手能做点什么 |
| --- | --- |
| **文件转换** | 将 PDF、DOCX、XLSX、图像和20+格式转换为 Markdown/text/HTML/JSON |
| **数据提取** | 运行由计划驱动的提取(同步/同步),估计符号,重运行,检查结果 |
| **AI 网关** | 通过OpenAI兼容网关聊天补全和回复(代理或直接模式),列出可用的模式 |
| **译名** | 将音频(FLAC、MP3、MP4、OGG、WAV、WebM)转换为文本、JSON、SRT、VTT |
| **示马斯** | CRUD、版本、标签、验证和样本文件测试 |
| **提示** | 版本的即时管理、标签、汇编、测试 |
| **数据集和实验** | 建立数据集,运行实验,管理评估员,记录分数 |
| **探员** | CRUD, 版本, 标签, 包含完整的结果信封, 批准决定, 工具批准历史, 工具目录同步历史 |
| **对话** | 创建/检查/删除对话框并重放其响应项目 API |
| **知识库** | CRUD、文档上传/附图/版本、混合搜索和引用解析 |
| **文件** | 上传、列表、下载和删除文件(代理输入或知识文档) |
| **内存** | 列出、读取、写入和删除您自己的代理存储文件, 忘记一切; 管理员看到成员总数并去除成员 |
| **观察性** | 分析(使用、质量、提供者、错误)、追踪、计费限额 |
| **API 文件** | 按区域浏览平台 API 文档 |

## 为什么是2kw.ai

-   **欧盟数据居住情况** 由Manfred Kunze Development GmbH(德国)运营的符合GDPR的内置模型和欧盟托管的模型
-   **一个平台** 网关、取出、抄录和可观察性共享一个API、一个仪表板、一个账单
-   **底分数** ——每一个取出的价值链接回溯到源文件的出处

## 相关

-   [2kw.ai (英语)](https://2kw.ai/) ——平台概况和定价
-   [文档](https://docs.2kw.ai/) ——全API参考和指南
-   [`@2kw/ai`](https://www.npmjs.com/package/@2kw/ai) 2kw.ai CLI (英语:`2kw`, (中文(简体) ), `backbone`, (中文(简体) ), `bb`用于终端和代理工作流程

## 许可证

专有——见 [自由主义](https://npmcn.com/package/%402kw/ai-mcp-server/LICENSE) 详细情况.

## 常见问题

### @2kw/ai-mcp-server 是什么？

2kw\.ai的MCP服务器——由欧盟主办的AI平台:OpenAI兼容LLM网关,由计划驱动的文件提取,抄写,具有知识基础的代理,成本可观察性\. 199个工具用于克洛德代码,Cursor,和Windsurf\.

### 如何安装 @2kw/ai-mcp-server？

在项目目录运行 npm install @2kw/ai-mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 2kw-mcp、backbone-mcp，可以用 npx 2kw-mcp 直接运行。

### @2kw/ai-mcp-server 支持 TypeScript 吗？

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

### @2kw/ai-mcp-server 支持 ESM 还是 CommonJS？

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

### @2kw/ai-mcp-server 需要什么版本的 Node\.js？

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

### @2kw/ai-mcp-server 可以商用吗？

@2kw/ai-mcp-server 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @2kw/ai-mcp-server 的下载量有多少？

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

### @2kw/ai-mcp-server 还在维护吗？

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