# @agenticprimitives/mcp-runtime 中文文档

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

版本：1\.0\.0-alpha\.46
npm 元数据更新时间：2026-10-26T11:49:22.709Z
中文译文更新时间：2026-11-06T07:31:23.749Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：138 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：viem ^2\.52\.2，@agenticprimitives/audit ^1\.0\.0-alpha\.46，@agenticprimitives/types ^1\.0\.0-alpha\.46，@modelcontextprotocol/sdk \>=1\.31\.0 \<2，@agenticprimitives/delegation ^1\.0\.0-alpha\.46，@agenticprimitives/key-custody ^1\.0\.0-alpha\.46，@agenticprimitives/tool-policy ^1\.0\.0-alpha\.46，@agenticprimitives/rate-control ^0\.0\.0-alpha\.5，@agenticprimitives/verification-receipts ^0\.0\.0-alpha\.21
- 首次发布：2026-05-31T17:13:01.916Z
- 最新版本发布：2026-10-26T11:49:19.531Z
- 近 30 天下载量：4142（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

官方MCP TypeScript SDK周围的具有代表团意识的授权中间软件. 决策层 不是SDK.

## 安装

```sh
npm install @agenticprimitives/mcp-runtime
```

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

## README

# @ agenticprimitives/ mcp 运行时间

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

**授权网络应用会话的同一代表团授权MCP工具呼叫.** 大多数带有API密钥或 OAuth 瞄准镜的 MCP 服务器门工具——无记名证书,其中未提及 _5分钟前是否被撤销_本套件用代理代理代理代理代理取代了原型:由EIP-712签名、有戒备限制、可连锁吊销的代理代理代理赠款。 当主撤销时,工具停止工作. 当时间窗口关闭时,工具停止工作. 没有密钥旋转,没有范围审计,没有猜测.

部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

这个包是 **决策层**而不是SDK的枪 官员 `@modelcontextprotocol/sdk` 已经提供了工具/资源/即时注册,运输,和OAuth 2.1 + PKCE + RFC-9728 + RFC-8707 管道(由2026-03-15 MCP spec授权)——你把它作为同伴依赖. 我们把桥加到 `@agenticprimitives/delegation` + 键 `@agenticprimitives/tool-policy`:一包将"任何有URL的人"变为"确切地说,是拥有活泼的,范围化的赠款的校长". 它还取消了智能代理三台成熟的MCP服务器上观察到的~65%的授权码重复.

见 [`spec.md`](https://npmcn.com/package/%40agenticprimitives/mcp-runtime/spec.md) → [`specs/205-mcp-runtime.md`](https://npmcn.com/package/specs/205-mcp-runtime.md),以及 [ADR-0004 (韩语)](https://npmcn.com/package/docs/architecture/decisions/0004-mcp-runtime-as-middleware.md) 为什么是中间软件 不是SDK.

## 快开始

```ts
import { McpServer } from '@modelcontextprotocol/sdk/server';
import { withDelegation, createSqliteJtiStore } from '@agenticprimitives/mcp-runtime';

const config = {
  audience: 'urn:mcp:server:person',
  chainId: 31337,
  rpcUrl: process.env.RPC_URL!,
  delegationManager: process.env.DELEGATION_MANAGER_ADDRESS as `0x${string}`,
  enforcerMap,
  jtiStore: createSqliteJtiStore(db, 'token_usage'),
};

const server = new McpServer({ name: 'person-mcp', version: '0.1.0' });

server.registerTool({
  name: 'get_profile',
  inputSchema: { type: 'object', properties: { token: { type: 'string' } } },
  handler: withDelegation(config, async ({ principal }) => {
    return db.profiles.findUnique({ where: { ownerAddress: principal } });
  }),
});
```

处理器不再接触Auth. 包装器在每通电话上运行全管: HMAC信封检查 →会话键签名 → EIP-712 hash → 在链上 `isRevoked` ∗ ERC-1271 核查 \* 提醒(未关闭) \* JTI用途跟踪 \* `tool-policy.evaluatePolicy` - 手 - 手 - 手 `{ principal, grants? }` 到内接者. 拒绝返回一个单一的统一认证失败错误——外部,一个畸形的代币与一个已过期,被撤销,或被警告失败的代币是无法区分的,所以检测什么也没有泄露.

## 什么样的船

-   **`withDelegation`** ——上方的"工具手"包装;头条功能.
-   **JTI 重放保护** —— 说 `createSqliteJtiStore`, (中文(简体) ), `createPostgresJtiStore`, (中文(简体) ), `createMemoryJtiStore`; 原子单用途跟踪在并发写法下.
-   **`declareResource`** 参加 `tool-policy` 与 MCP 资源元数据进行分类.
-   **`verifyDelegationForResource`** ——低水平核查入站.
-   **服务对服务** —— 说 `generateServiceMac` 编号 : `verifyServiceMac` 用于服务间HTTP信封.
-   **测试带** (单位:千美元)`/testing` (副路径)- `MockDelegationSigner`, (中文(简体) ), `createTestConfig`, (中文(简体) ), `withMockedDelegationContext`。 。 。 .
-   **分类** (单位:千美元)`/lint` (副路径)- `lintMcpClassification`, MCP 默认关闭 `tool-policy.lintClassification`。 。 。 .
-   **审计活动** —— 说 `mcp-runtime.with-delegation.{accept,reject}` 财务报告和审定财务报表 `mcp-runtime.service-mac.{accept,reject}`,通过呼叫器提供连接 `correlationId` (单位:千美元)[第206区](https://npmcn.com/package/specs/206-audit.md)) (中文(简体) ).

## 怎么不一样

竞争模式是 **OAuth 瞄准镜、 API 密钥和 MCP 认证中间软件** 服务器侧允许列表对照无记名证书检查。 本套件缩小了三个结构上的差距:

-   **证相.** 一个瞄准镜弦会说什么,一个代表团可以证明 _谁同意的_ ——校长的"智能特工"签名,对照连锁账户核实了ERC-1271. 每一次被接受的通话都是由犬科地址,而不是API-键行决定的.
-   **直播撤销.** API 密钥通过在所漏出的地方旋转来被取消. 一个代表团被吊销一次 连锁检查 `isRevoked` 每一个电话.
-   **一个模型跨越地表.** 您的用户在网络应用中发放的补助金是您MCP服务器核实的相同的补助金—— 相同的警告(时间窗口,值上限,允许的方法), 相同的撤销, 相同的审计线索. ERC-8004 注册和代理的发现今年正在解决;获胜的底盘是工具访问、代理呼叫和链上支出共享单一权威模式的底盘。 这是这里的设计中心.

我们不取代MCP spec的运输级OAuth——它停留在官方SDK中. 我们回答的问题 OAuth不能: _这个工具现在由谁授权执行?_

## 跨代表团

从H7-B.8 (XPKG-002 / EXT-024闭合)的公用地表取出. 前一个 `withCrossDelegation` 是无条件拒绝的根茎 实验能力低于 `./experimental` 子路径;当交叉委托工作恢复时,它就在那里着陆. 见 [生产准备情况审计](https://npmcn.com/package/docs/audits/2026-05-packages-contracts-production-readiness.md) (PKG-mcp-runtime-001) (英语).

## 验证

```bash
pnpm --filter @agenticprimitives/mcp-runtime typecheck
pnpm --filter @agenticprimitives/mcp-runtime test
pnpm check:forbidden-terms
```

## 状态

测试网/飞行员准备 生产启动在根部的公开核对表上进行 [`README.md`](https://npmcn.com/package/README.md#status--honest-version) ——包括第三方合同审计和治理关键轮换. 追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml)光谱+API稳定; `capability.manifest.json` 标记此软件包 `experimental` 直到那些大门清空为止.

## 许可证

UNLICENSED(内部单列,未出版).

## 常见问题

### @agenticprimitives/mcp-runtime 是什么？

官方MCP TypeScript SDK周围的具有代表团意识的授权中间软件\. 决策层 不是SDK\.

### 如何安装 @agenticprimitives/mcp-runtime？

在项目目录运行 npm install @agenticprimitives/mcp-runtime，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.52\.2）、@agenticprimitives/audit（^1\.0\.0-alpha\.46）、@agenticprimitives/types（^1\.0\.0-alpha\.46）、@modelcontextprotocol/sdk（\>=1\.31\.0 \<2）、@agenticprimitives/delegation（^1\.0\.0-alpha\.46）、@agenticprimitives/key-custody（^1\.0\.0-alpha\.46）、@agenticprimitives/tool-policy（^1\.0\.0-alpha\.46）、@agenticprimitives/rate-control（^0\.0\.0-alpha\.5）、@agenticprimitives/verification-receipts（^0\.0\.0-alpha\.21）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/mcp-runtime 支持 TypeScript 吗？

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

### @agenticprimitives/mcp-runtime 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/mcp-runtime 可以商用吗？

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

### @agenticprimitives/mcp-runtime 的下载量有多少？

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

### @agenticprimitives/mcp-runtime 还在维护吗？

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