Oauth Husk

MCP安全风控

提供方 gwjr

安全风控 未标注 OAuth 授权 社区 / 第三方 Claude

一个简化的OAuth 2.0授权服务器,专为保护自托管MCP服务器设计,适用于单用户环境下的身份验证。

一句话选型结论

按资料字段整理

Oauth Husk 属于安全风控类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

OAuth2.0Go本地部署授权服务器单用户认证MCP集成轻量级

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Oauth Husk当前 6 未标注 未标注 无 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

服务器档案

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

详细介绍

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

鹅壳

用于保护自托管的最低OAuth 2.0授权服务器 主控程序 服务器。它实现了刚好足够Claude.ai(和其他MCP客户端)进行身份验证的规范,而没有多用户身份验证的复杂性。一个服务器,一个操作员,一组凭据。

为什么

Claude.ai要求OAuth连接到远程MCP服务器。如果你在Caddy后面自托管MCP服务器,你需要一些东西来处理OAuth舞蹈。oauth外壳就是这样:一个没有配置文件、没有外部依赖关系的单一二进制文件,以及一个自行创建的SQLite数据库。

它故意忽略了多用户的任何概念——没有登录页面,没有用户数据库,没有同意屏幕。您使用共享密钥注册客户端,任何具有这些凭据的MCP客户端都可以获得令牌。如果(但可能只有当!)您是唯一的用户,并且MCP服务器是您的,则这是合适的。

安全目标(实用):将oauth-husk视为与预共享承载令牌/API密钥的风险大致相等,同时提供MCP客户端所需的oauth流。

运作原理```

Claude.ai → Cloudflare → Caddy → oauth-husk (:8200) — OAuth endpoints
→ your MCP server — after forward_auth


1. Claude.ai通过以下方式发现OAuth端点 `/.well-known/` 元数据
1. 它从以下位置获取授权码 `/authorize` (使用PKCE)
1. 它将代码交换为令牌 `/token`
1. 在每次MCP请求时,Caddy都会调用oauth husk的 `/auth/verify` 端点
1. 如果令牌有效,Caddy会将请求代理到您的MCP服务器

oauth husk永远看不到你的MCP流量。它只是说“是”或“否”。

## 快速开始```bash
go build

# Install as a launchd service (macOS)
./oauth-husk install

# Register a client
./oauth-husk client add claude-mcp
# → prints the client secret once — save it

# Point Caddy at it (see Caddyfile in this repo)

命令```

oauth-husk serve Start the server (foreground)
oauth-husk install Install and start as a launchd service
oauth-husk uninstall Stop and remove the launchd service
oauth-husk client add Register a client, print its secret
oauth-husk client list List registered clients
oauth-husk client revoke Revoke all tokens for a client


`serve` 和 `install` 接受 `--port` (默认值8200), `--db` (默认值 `~/.config/oauth-husk/oauth.db`), `--allow-from` (逗号分隔的CIDR/IPs;仅默认环回,例如。 `--allow-from 127.0.0.0/8,::1/128,172.18.0.0/16` Docker),以及 `--allow-insecure-http` 用于没有TLS的本地测试。数据库和签名密钥在首次运行时自动创建。

## 球童设置

oauth外壳设计用于坐在Caddy后面 `forward_auth`。其中包括一个示例Caddyfile——关键部分:```
@oauth path /.well-known/oauth-protected-resource /.well-known/oauth-authorization-server /authorize /token
handle @oauth {
reverse_proxy localhost:8200
}

@mcp path /mcp /sse /messages
handle @mcp {
forward_auth localhost:8200 {
uri /auth/verify
}
reverse_proxy localhost:8105
}

客户端设置

注册客户端时,您可以选择锁定其重定向URI:```bash
./oauth-husk client add claude-mcp --redirect-uri https://claude.ai/api/mcp/auth_callback


如果你忽略了 `--redirect-uri`,自动捕获并锁定第一次成功授权的URI。之后,只接受那个确切的URI。

## 设计选择

- **没有配置文件。** 标记两个不同的东西(端口和DB路径)。基本URL来源于Caddy的转发标头。
- **没有CGO。** 用途 `modernc.org/sqlite` 纯粹的Go构建。单一静态二进制文件。
- **数据库中的签名密钥。** 首次运行时自动生成,存储在 `settings` 桌子。命令行或文件中没有秘密。
- **访问令牌是签名的,无状态的。** `/auth/verify` 仅验证签名+过期。刷新令牌以哈希方式存储,用于轮换和撤销。
- **bcrypt用于客户端机密。** 成本12。即使对于未知的客户端ID,也能进行定时安全比较。

## 运行测试```bash
go test ./...

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Oauth Husk 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Oauth Husk 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Oauth Husk 收费吗?

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

Oauth Husk 需要 API Key 吗?

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

Oauth Husk 支持哪些客户端?

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

Oauth Husk 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 Go、Claude、轻量级。具体工具清单以官方文档为准。

热门专题

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

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