# @btravstack/mcp-server 中文文档

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

版本：0\.58\.0
npm 元数据更新时间：2026-11-07T21:12:44.321Z
中文译文更新时间：2026-11-08T19:22:09.314Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：28.3 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12
- 运行依赖：0 个
- peer 依赖：unthrown ^5\.7\.0，@btravstack/di ^0\.58\.0，@btravstack/core ^0\.58\.0，@btravstack/contract ^0\.58\.0，@btravstack/http-server ^0\.58\.0，@modelcontextprotocol/sdk ^1\.32\.1
- 首次发布：2026-10-17T17:28:34.571Z
- 最新版本发布：2026-11-07T21:12:43.968Z
- 近 30 天下载量：3520（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

@btravstack/http-server的示范背景协议解答器, 覆盖官方 SDK

## 安装

```sh
npm install @btravstack/mcp-server
```

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

## README

# @btravstack/mcp-服务器

A 类 [示范背景协议](https://modelcontextprotocol.io/) 回答 协议中性 [`@btravstack/http-server`](https://npmcn.com/package/%40btravstack/http-server) 运行时间,在 正式 [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk)。 。 。 . SDK拥有协议; `mcp()` 拥有每次运行的时间 回答者:通过共享方案、请求单位和 身体限制.

```sh
pnpm add @btravstack/mcp-server @btravstack/http-server @btravstack/core \
  @btravstack/config @btravstack/di @btravstack/contract \
  @modelcontextprotocol/sdk zod unthrown
```

```ts
import { defineAuth } from "@btravstack/http-server";
import { mcp } from "@btravstack/mcp-server";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { OkAsync } from "unthrown";

export const answerer = mcp(defineAuth(), {
  server: ({ toolResult }) => {
    const server = new McpServer({ name: "hello", version: "1.0.0" });
    server.registerTool("hello", { inputSchema: {} }, () => toolResult(OkAsync("world")));
    return server;
  },
});
```

`server` 建造 SDK 自己的 `McpServer` 一个请求: 无国籍并回答JSON,所以任何复制品都会回答任何请求. 交给你了 页:1 `principal` 那个 `requires` 解决 `unit` 记录删除 准备的,请求的 `signal`,以及 `toolResult`,用于回答工具 从a `Result` —— 说 `Ok` 作为正文,或平面对象的结构化内容, `Err` a 包括: `ToolRefused` 作为工具 错误 `text` 模型读取,一个缺陷作为通用工具错误报告 `Observers`。 。 。 .

`McpModule("Name")({ answerer })` 是部署根,因为 `GraphqlModule` 是图QL的.

呼叫者,不需要接受要求,就会空手而归 `401`,一个范围不足的一个a `403`编曲 `protectedResource()` 从 `@btravstack/http-server` 编辑 `401` 告诉 MCP 客户端在哪里签名 - 或 `protectedResourcePerHost()`, (中文(简体) ), 用于每个租户域一个资源.

见 [服务 MCP](https://btravstack.github.io/btravstack/how-to/serve-mcp)。 。 。 .

## 常见问题

### @btravstack/mcp-server 是什么？

@btravstack/http-server的示范背景协议解答器, 覆盖官方 SDK

### 如何安装 @btravstack/mcp-server？

在项目目录运行 npm install @btravstack/mcp-server，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：unthrown（^5\.7\.0）、@btravstack/di（^0\.58\.0）、@btravstack/core（^0\.58\.0）、@btravstack/contract（^0\.58\.0）、@btravstack/http-server（^0\.58\.0）、@modelcontextprotocol/sdk（^1\.32\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @btravstack/mcp-server 支持 TypeScript 吗？

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

### @btravstack/mcp-server 支持 ESM 还是 CommonJS？

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

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

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

### @btravstack/mcp-server 可以商用吗？

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

### @btravstack/mcp-server 的下载量有多少？

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

### @btravstack/mcp-server 还在维护吗？

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