MCP Oauth Proxy Demo

MCP安全风控

提供方 vikrantjain

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

一个演示FastMCP服务器通过OAuth代理模式与不支持动态客户端注册(DCR)的Keycloak进行认证的解决方案。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

OAuth代理Python本地部署动态客户端注册Keycloak集成认证服务安全协议

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run -d \

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

FastMCP Keycloak OAuth代理演示

FastMCP服务器示例演示 OAuth代理模式 用于使用Keycloak进行身份验证,Keycloak是一个不支持动态客户端注册(DCR)的传统OAuth提供程序。

为什么选择OAuth代理?

MCP客户端希望使用动态客户端注册(DCR)-他们希望自动注册并动态获取凭据。然而,Keycloak(与GitHub、Google和Azure等大多数传统OAuth提供商一样)需要通过管理控制台手动注册应用程序。

这 OAuth代理 通过以下方式弥合这一差距:

  • 向MCP客户端展示符合DCR的接口
  • 在幕后使用预先注册的Keycloak凭据
  • 处理动态客户端重定向URI的回调转发
  • 发行FastMCP JWT令牌,而不是直接转发上游令牌

这保持了适当的OAuth 2.0安全边界,同时提供了无缝的MCP客户端集成。

演示的主要功能

  • OAuth代理模式:将DCR不兼容的OAuth提供程序与MCP客户端连接起来
  • 动态客户端注册仿真:接受客户端注册请求并返回预先配置的凭据
  • 双PKCE安全:客户端到代理和代理到上游层的端到端PKCE
  • 令牌工厂模式:发行FastMCP JWT令牌,而不是转发上游令牌
  • 回拨转发:支持动态客户端重定向URI(随机本地主机端口、固定URL)
  • JWT令牌验证:使用Keycloak的JWKS端点验证令牌
  • 同意屏幕:防止混淆的副手攻击
  • FastMCP功能:工具、资源和提示示例

建筑```mermaid

sequenceDiagram
participant Client as MCP Client
participant Proxy as FastMCP OAuthProxy
participant Keycloak as Keycloak OAuth Provider
participant User

Note over Client,Keycloak: Phase 1: Discovery & Registration
Client->>Proxy: 1. POST /mcp (initialize)
Proxy-->>Client: 401 Unauthorized + metadata URL

Client->>Proxy: 2. GET /.well-known/oauth-protected-resource/mcp
Proxy-->>Client: OAuth server metadata

Client->>Proxy: 3. POST /register (DCR with redirect_uri)
Note over Proxy: Records client redirect_uri
Returns pre-configured credentials
Proxy-->>Client: client_id (fixed upstream credentials)

Note over Client,Keycloak: Phase 2: Authorization with Dual-PKCE
Client->>Proxy: 4. GET /authorize?code_challenge=...
Note over Proxy: Stores client PKCE challenge
Generates own PKCE for upstream
Proxy-->>User: Show consent page
User->>Proxy: Approve client
Proxy->>Keycloak: Redirect to /authorize (proxy PKCE)

Keycloak-->>User: Login page
User->>Keycloak: Authenticate
Keycloak-->>Proxy: Authorization code

Note over Client,Keycloak: Phase 3: Token Exchange
Proxy->>Keycloak: POST /token (code + proxy verifier)
Keycloak-->>Proxy: Upstream access_token
Note over Proxy: Encrypts & stores upstream token
Issues new FastMCP JWT
Proxy-->>Client: Redirect to client redirect_uri + code

Client->>Proxy: 5. POST /token (code + client verifier)
Note over Proxy: Validates client PKCE
Returns FastMCP JWT
Proxy-->>Client: FastMCP JWT token

Note over Client,Keycloak: Phase 4: Authenticated Requests
Client->>Proxy: 6. POST /mcp (with FastMCP JWT)
Note over Proxy: Validates FastMCP JWT
Verifies upstream token
Proxy-->>Client: Protected MCP resources


## 运作原理

1. **问题**:MCP客户端期望动态客户端注册(DCR)-他们希望自动注册并即时获得凭据。Keycloak需要通过其管理控制台手动注册应用程序。

1. **解决方案**:OAuthProxy在幕后使用预先注册的Keycloak凭据时,向MCP客户端提供符合DCR的接口。

1. **流量**:

- 当客户端注册时,代理返回您的固定Keycloak凭据并存储客户端的回调URL
- 当客户端授权时,代理使用Keycloak的固定回调URL,然后转发回客户端的动态回调
- 代理发出自己的FastMCP JWT令牌(用HS256签名),而不是直接转发Keycloak令牌
- 这保持了适当的OAuth 2.0受众边界,并实现了更好的安全控制

## 先决条件

- **Python 3.12+**:FastMCP需要
- **码头工人**:用于在本地运行Keycloak
- **紫外线**:Python包管理器
- 安装紫外线: `curl -LsSf https://astral.sh/uv/install.sh | sh`
- 或者看看 紫外线安装文档

## 安装

### 1.克隆存储库```bash
git clone https://github.com/vikrantjain/mcp-oauth-proxy-demo.git
cd mcp-oauth-proxy-demo

2.安装依赖项```bash

uv sync


## 配置

### 1.使用Docker启动Keycloak```bash
docker run -d \
--name keycloak \
-p 8080:8080 \
-e KEYCLOAK_ADMIN=admin \
-e KEYCLOAK_ADMIN_PASSWORD=admin \
quay.io/keycloak/keycloak:latest \
start-dev

访问Keycloak管理控制台http://localhost:8080(凭据:admin/admin)

2.在Keycloak中创建客户端

  1. 导航到 客户 在左侧边栏中
  2. 点击 创建客户端
  3. 配置客户端:
    - 客户端ID: mcp_server
    - 客户端认证:ON(机密客户)
    - 有效的重定向URI: http://localhost:8000/auth/callback
    - 有效的注销后重定向URI: http://localhost:8000
  4. 保存客户端
  5. 去 凭证 选项卡并复制 客户端密钥

3.配置环境变量```bash

cp .env.example .env

Edit .env and add your Keycloak client secret


更新 `.env` 根据您的实际值:```env
KEYCLOAK_CLIENT_ID=mcp_server
KEYCLOAK_CLIENT_SECRET=
KEYCLOAK_BASE_URL=http://localhost:8080
KEYCLOAK_REALM=master
MCP_SERVER_BASE_URL=http://localhost:8000

运行服务器```bash

uv run fastmcp run mcp-server.py --transport streamable-http --host 0.0.0.0 --port 8000


服务器将于启动http://localhost:8000

## 使用示例

### 1.Python客户端(FastMCP客户端)```bash
uv run python mcp-client.py

此客户端演示:

  • 呼叫 greet 工具
  • 阅读 resource://server/config 资源(OAuth配置)
  • 获取 explain_oauth_flow 提示

2.REST客户端(VS代码REST客户端扩展)

安装 REST客户端扩展 对于VS代码。

使用 client-proxy.rest 要使用动态客户端注册测试完整的OAuth代理流,请执行以下操作:

  1. 打开 client-proxy.rest
  2. 遵循OAuth的分步流程:
    - 发现和元数据检索
    - 动态客户端注册
    - 使用PKCE进行授权
    - 代币兑换
    - 经过身份验证的MCP请求

备注: client.rest 包含未经身份验证的引用请求,但由于服务器需要OAuth身份验证,因此将失败。

项目结构```

.
├── mcp-server.py # FastMCP server with OAuthProxy configuration
├── mcp-client.py # Python client example using FastMCP Client
├── client.rest # Simple MCP API tests (REST Client)
├── client-proxy.rest # Complete OAuth flow demonstration
├── pyproject.toml # Python project dependencies
├── uv.lock # Dependency lock file
├── .env.example # Environment variables template
├── .env # Your actual environment variables (gitignored)
├── .gitignore # Git ignore patterns
├── .python-version # Python version specification (3.12)
└── README.md # This file
```

安全特性

  • 双PKCE:客户端到代理和代理到上游层的端到端PKCE
  • 使用者同意:客户授权前需要明确批准
  • 加密令牌存储:用于存储令牌的AES-128-CBC+HMAC-SHA256加密
  • JWT签名验证:FastMCP令牌的HS256签名验证
  • 受众验证:防止不同服务之间的令牌滥用
  • 困惑的副保护:同意屏幕可防止恶意客户端模拟

了解更多

  • FastMCP OAuth代理文档
  • FastMCP文档
  • MCP规范
  • Keycloak文档

许可证

MIT许可证-有关详细信息,请参阅许可证文件

贡献

欢迎投稿!请随时提交拉取请求。

常见问题

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

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

MCP Oauth Proxy Demo 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Oauth Proxy Demo 收费吗?

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

MCP Oauth Proxy Demo 需要 API Key 吗?

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

MCP Oauth Proxy Demo 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 安全协议、Python、认证服务。具体工具清单以官方文档为准。

MCP Oauth Proxy Demo 需要什么运行环境?

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

MCP Oauth Proxy Demo 是本地还是远程?

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

热门专题

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

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