oauth (MCP Z)

@mcp-z/oauth

文件：https://mcp-z.github.io/oauth MCP服务器的多帐户OAuth编排和令牌存储。

常见用途

• 向MCP服务器添加一致的帐户工具
• 使用共享配置和存储后端存储OAuth令牌
• 在Google和Microsoft提供商之间重复使用相同的帐户生命周期

安装

npm install @mcp-z/oauth

可选存储后端：

npm install keyv-duckdb
npm install keyv-file

初始化令牌存储

npx @mcp-z/oauth init

这创建了一个 .tokens/ 目录和用于令牌存储的默认配置文件。

账户工具和模式

使用 AccountServer 将帐户工具添加到MCP服务器。

环回模式（多账户）

使用环回OAuth时，会添加以下工具：

• account-me
• account-switch
• account-remove
• account-list

无状态模式（DCR/承载）

使用无状态身份验证（DCR/承载令牌）时，只有此工具可用：

• account-me

示例

import { AccountServer } from '@mcp-z/oauth';

const { tools, prompts } = AccountServer.createLoopback({
  service: 'gmail',
  store: tokenStore,
  logger,
  auth: authProvider
});

日志助手

使用 sanitizeForLoggingFormatter 以避免日志中的秘密泄露。

需求

• Node.js>=22