# @agenticprimitives/mcp-oauth 中文文档

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

版本：0\.0\.0-alpha\.22
npm 元数据更新时间：2026-10-26T11:09:36.841Z
中文译文更新时间：2026-11-06T08:37:42.269Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：86.2 kB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.45
- 首次发布：2026-06-17T16:46:30.834Z
- 最新版本发布：2026-10-26T11:09:28.912Z
- 近 30 天下载量：3785（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

MCP OAuth相容适配器(Spec 277 §6-§8,§15):被保护资源元数据,范围,WWW-Authenticate,无记名证书索赔验证,以及Agentic Grant Bundle桥. OAuth只是入侵对手 而不是金库的负责人.

## 安装

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

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

## README

# @ agenticprimitives/ mcp-oauth (英语)

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

MCP 磁共振 **OAuth 兼容性** 适配器 + **代理赠款套装** 桥( 第277段). OAuth是一个入侵者 公共HTTP MCP客户端的适配器 - **没有** 保险库的权威。 已确认的代号 由 id+hash 捆绑; 普通的已授权金库路径会关闭捆绑 .

```ts
import { validateMcpBearerToken, resolveGrantBundleFromToken, buildInsufficientScopeResponse } from '@agenticprimitives/mcp-oauth';

const v = await validateMcpBearerToken(parseBearer(req.headers.get('authorization')), {
  verify: (tok) => jwks.verify(tok),          // injected: signature + decode → claims
  audience: 'https://mcp.example.com/mcp',
  requiredScopes: ['mcp:invoke', 'vault:pii:read'],
  requireGrantBinding: true,
});
if (!v.ok) return v.reason === 'insufficient_scope'
  ? buildInsufficientScopeResponse({ missingScopes: v.missingScopes!, resourceMetadataUrl })
  : buildUnauthorizedResponse({ resourceMetadataUrl });

const r = await resolveGrantBundleFromToken(v.claims, grantBundleStore);  // store injected
// r.bundle → delegation/entitlement hashes → normal delegated vault path
```

无依赖性+运行时间不可知. 授权服务器 JWT/JWKS 校验和加密 grant-bundle商店在应用程序/运行时间进行直播。 入境的MCP令牌在下游从未被再利用. 见 [第277页,第6节,第15节](https://npmcn.com/package/specs/277-mcp-delegated-vault-authorization.md)。 。 。 .

## 常见问题

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

MCP OAuth相容适配器\(Spec 277 §6-§8,§15\):被保护资源元数据,范围,WWW-Authenticate,无记名证书索赔验证,以及Agentic Grant Bundle桥\. OAuth只是入侵对手 而不是金库的负责人\.

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

在项目目录运行 npm install @agenticprimitives/mcp-oauth，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agenticprimitives/types（^1\.0\.0-alpha\.45）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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