MCP Auth Wrapper

MCP安全风控

提供方 domdomegg · 包名 mcp-auth-wrapper

安全风控 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

将本地MCP服务器转换为支持多租户的远程服务,提供用户认证和配置管理功能。

一句话选型结论

按资料字段整理

MCP Auth Wrapper 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP服务TypeScript本地部署多租户OAuth认证AI工具集成配置管理

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx -y mcp-auth-wrapper

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Auth Wrapper当前 1 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方domdomegg上游标注的维护方 domdomegg
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时mcp-auth-wrapper · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.9 KB
来自项目仓库与上游目录的原文,未做删改

mcp身份验证包装器

> 转向任何本地 MCP服务器 将每个用户的凭据转换为多租户托管的远程MCP。

将AI代理与工具连接可以帮助您和您的团队提高工作效率。 MCP服务器 是一种很好的方法,但其中许多仅在本地运行,并且需要每个用户设置(如API密钥),这对非技术用户来说可能很困难。如果你想让你的整个团队都使用一个,每个人都有自己的证书,该怎么办?

mcp-auth-wrapper允许您做到这一点:它为具有身份验证和配置的多个用户托管任何mcp服务器。您的团队可以通过现有的身份提供者(Google Workspace、Microsoft Entra ID、Okta、Auth0、Keycloak等)登录,在简单的表单界面中提供每个用户的配置,mcp-auth-wrapper将自动为每个用户启动mcp。

mcp-auth-wrapper可与Claude.ai、Claude Code和支持远程服务器的任何其他mcp客户端配合使用。

对于那些对技术细节感兴趣的人来说,mcp-auth-wrapper将接受环境变量的stdio mcp服务器包装为 可流式传输HTTP 服务器与 OAuth 2.1 / OpenID连接默认情况下,用户凭据仅保存在内存中,但可以持久化到sqlite中——如果这样做,建议使用加密卷进行存储。mcp-auth-wrapper可横向扩展,适用于更大的部署,并且可以使用npx、Docker、Docker Compose或Kubernetes轻松运行。

用法

集 MCP_AUTH_WRAPPER_CONFIG 转到JSON配置对象并运行:```bash
MCP_AUTH_WRAPPER_CONFIG='{
"command": ["npx", "-y", "airtable-mcp-server"],
"auth": {"issuer": "https://auth.example.com"}
}' npx -y mcp-auth-wrapper


这将在localhost:3000上启动HTTP MCP服务器。当用户连接时,他们将被重定向到您的登录提供商。登录后,如果您配置了每个用户的环境变量(如API键),他们将看到一个表单来输入它们。然后,它们连接到自己的MCP服务器进程。

Other configuration methods

env-var也可以指向文件路径:```bash
MCP_AUTH_WRAPPER_CONFIG=/path/to/config.json npx -y mcp-auth-wrapper

或创建 mcp-auth-wrapper.config.json 在工作目录中,它会被自动拾取:```bash
npx -y mcp-auth-wrapper


Running with Docker```bash
docker run -e 'MCP_AUTH_WRAPPER_CONFIG={"command":["npx","-y","airtable-mcp-server"],"auth":{"issuer":"https://auth.example.com"}}' -p 3000:3000 ghcr.io/domdomegg/mcp-auth-wrapper

Running on Kubernetes

Docker镜像以非root身份运行 node 用户(uid 1000)。如果您将PersistentVolumeClaim用于SQLite存储,默认情况下卷装载将由root拥有,因此容器将无法写入。添加 fsGroup: 1000 转到pod的安全上下文以修复此问题:```yaml
spec:
securityContext:
fsGroup: 1000
containers:
- name: mcp-auth-wrapper
image: ghcr.io/domdomegg/mcp-auth-wrapper
volumeMounts:
- name: data
mountPath: /data
volumes:
- name: data
persistentVolumeClaim:
claimName: mcp-auth-wrapper-data


### 配置

仅 `command` 和 `auth.issuer` 是必需的。其他一切都有合理的违约。

完整示例:```json
{
"command": ["npx", "-y", "airtable-mcp-server"],
"auth": {
"issuer": "https://keycloak.example.com/realms/myrealm",
"clientId": "my-wrapper",
"clientSecret": "...",
"scopes": ["openid", "profile"],
"userClaim": "preferred_username"
},
"envBase": {"NODE_ENV": "production"},
"envPerUser": [
{"name": "AIRTABLE_API_KEY", "label": "Airtable API Key", "secret": true}
],
"storage": "/data/mcp.sqlite",
"port": 3000,
"host": "0.0.0.0",
"issuerUrl": "https://mcp.example.com",
"secret": "a-fixed-signing-key"
}
字段 必填 描述
command Yes 将MCP服务器作为数组生成的命令(例如。 ["npx", "-y", "some-server"]).
auth.issuer 是 您的登录提供商的URL。必须支持 OpenID连接发现.
auth.clientId 没有 在您的登录提供商处注册的客户端ID。默认为 "mcp-auth-wrapper".
auth.clientSecret 否 客户端机密。为公众客户省略。
auth.scopes 无 登录时请求的范围。默认为 ["openid"].
auth.userClaim 否 登录令牌中的哪个字段标识用户。默认为 "sub".
envBase 否 所有用户进程共享的环境变量。
envPerUser 首次登录时没有 要收集的用户环境变量(例如API密钥)。各自 name, label,可选 description 和 secret.
storage 否 存储用户参数的位置: "memory" (默认)、SQLite文件路径或内联对象(请参见 在......下面).
port 无 要监听的端口。默认为 3000.
host 无 要绑定的主机。默认为 0.0.0.0.
issuerUrl 否 此服务器的公共URL。在反向代理后面时需要。
secret 没有 令牌的签名密钥。如果未设置,则为随机。设置一个固定值以在重新启动后继续运行。

用户可以随时通过 重新配置 自动添加到MCP服务器的工具列表中的工具。

Advanced: scaling and persistence

所有身份验证状态(令牌、会话、正在进行的登录)都是无状态的——令牌是自包含的加密blob,每个请求都会得到一个新的传输。除了用户参数(in storage)以及进程池(每个用户一个子进程)。

要在重新启动后继续运行,请设置 secret 将用户参数设置为固定值,并使用SQLite文件或内联存储。

要在负载平衡器后运行多个实例,请设置 secret 在实例和点之间达到相同的值 storage 在共享SQLite文件中(或使用内联存储)。如果用户点击不同的实例,它只会生成一个新的子流程——这对无状态MCP是透明的。

登录提供者示例

Google Workspace```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://accounts.google.com",
"clientId": "...",
"clientSecret": "..."
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}


在中创建OAuth 2.0凭据 谷歌云控制台。选择“Web应用程序”,添加 `https:///callback` 作为授权的重定向URI。要限制对组织的访问,请将OAuth同意屏幕配置为“内部”。

Microsoft Entra ID```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://login.microsoftonline.com//v2.0",
"clientId": "...",
"clientSecret": "..."
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}

在 Azure门户.添加 https:///callback 作为“Web”下的重定向URI。在“证书和机密”下创建客户端机密。替换 `` 使用您的目录(租户)ID。

Okta```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://your-org.okta.com",
"clientId": "...",
"clientSecret": "..."
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}


在Okta中创建Web应用程序。将登录重定向URI设置为 `https:///callback`。发行人URL是您的Okta组织URL(或自定义授权服务器URL,如果您使用的话)。

Keycloak```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://keycloak.example.com/realms/myrealm",
"clientSecret": "..."
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}

使用客户端ID在Keycloak领域中创建OpenID Connect客户端 mcp-auth-wrapper (或设置 auth.clientId 匹配)。将重定向URI设置为 https:///callback。用户由以下人员标识 sub 默认情况下为(Keycloak用户ID)。集 auth.userClaim 到 preferred_username 改为按用户名匹配。

Auth0```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://your-tenant.auth0.com",
"clientId": "...",
"clientSecret": "..."
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}


在Auth0中创建常规Web应用程序。添加 `https:///callback` 作为允许的回调URL。设置 `auth.clientId` 到Auth0应用程序的客户端ID `sub` Auth0中的声明通常以连接类型作为前缀(例如。 `auth0|abc123`).

Authentik```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://authentik.example.com/application/o/myapp/",
"clientSecret": "...",
"userClaim": "preferred_username"
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}

使用客户端ID在Authentik中创建OAuth2/OpenID提供程序 mcp-auth-wrapper (或设置 auth.clientId 匹配)。将重定向URI设置为 https:///callback.

Home Assistant (via hass-oidc-provider)

Home Assistant本身不支持OpenID Connect。使用 hass oidc提供商 为了弥合差距,它与Home Assistant一起运行,并添加了缺失的部分。```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://hass-oidc-provider.example.com"
},
"envPerUser": [{"name": "API_KEY", "label": "API Key", "secret": true}]
}


点 `auth.issuer` 在您的hass-oidc提供商实例上(而不是直接在Home Assistant上)。这 `sub` claims是家庭助理用户ID。否 `clientId` 或 `clientSecret` 需要。

### 其他示例

Inline users (no self-registration)

默认情况下,用户在首次登录时通过表单输入自己的凭据(例如API密钥),然后可以通过重新配置工具更新这些凭据。如果你更愿意预先硬编码所有用户,请使用内联 `storage` 对象:```json
{
"command": ["npx", "-y", "some-mcp-server"],
"auth": {
"issuer": "https://auth.example.com",
"clientSecret": "..."
},
"storage": {
"adam": {"API_KEY": "patXXX_adam"},
"bob": {"API_KEY": "patXXX_bob"}
}
}

用户通过以下方式匹配 auth.userClaim (默认值: sub)从登录令牌中。内联存储是只读的,用户无法更新自己的凭据。

贡献

GitHub上欢迎拉取请求!开始:

  1. 安装Git和Node.js
  2. 克隆仓库
  3. 安装依赖项 npm install
  4. 跑 npm run test 运行测试
  5. 建立 npm run build

发布

版本遵循 语义版本规范.

要发布:

  1. 使用 npm version 升级版本
  2. 跑 git push --follow-tags 使用标签推送
  3. 等待GitHub Actions发布到NPM注册表和GHCR(Docker)。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Auth Wrapper 怎么安装?

在客户端按下面的安装命令接入:npx -y mcp-auth-wrapper。对应的包名是 mcp-auth-wrapper。装完在客户端配置里引用同一个包或端点。

MCP Auth Wrapper 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Auth Wrapper 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Auth Wrapper 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

MCP Auth Wrapper 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Auth Wrapper 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 多租户、配置管理、TypeScript、Claude、AI工具集成。具体工具清单以官方文档为准。

MCP Auth Wrapper 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Auth Wrapper 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。