self hosted oauth MCP

MCP安全风控

提供方 OhadRubin

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

一个自托管的MCP服务器,支持OAuth 2.0认证,使用Keycloak作为身份提供者,适用于需要自主控制基础设施的场景。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

自托管Python本地部署OAuth2.0身份认证KeycloakMCP协议

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run python client.py

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

自托管OAuth MCP服务器

一个自托管的MCP(模型上下文协议)服务器,使用Keycloak作为身份提供者进行OAuth 2.0身份验证。此设置允许您完全在自己的基础设施上运行受OAuth保护的MCP服务器,并支持动态URL(ngrok、反向代理等)。

特性

  • 使用PKCE的完整OAuth 2.0授权代码流
  • 动态客户端注册(DCR)支持
  • 适用于ngrok和其他反向代理
  • Keycloak作为身份提供者
  • FastMCP发行JWT代币
  • 预配置的测试用户和客户端

建筑```

┌─────────────┐ ┌─────────────────┐ ┌──────────────────┐
│ Client │─────▶│ nginx (:9000) │─────▶│ mcp-server │
│ │ │ │ │ (:8007) │
└─────────────┘ │ /mcp ──────────┼─────▶│ FastMCP + OAuth │
│ │ └──────────────────┘
│ /realms/* ─────┼─────▶┌──────────────────┐
│ /authorize │ │ Keycloak │
│ /token │ │ (:9090) │
└─────────────────┘ └──────────────────┘


- **引擎X**:端口9000上的反向代理,路由MCP流量和OAuth端点
- **钥匙斗篷**:OAuth 2.0/OpenID连接身份提供者
- **mcp服务器**:带有DynamicOIDCProxy的FastMCP服务器,用于URL感知身份验证

## 先决条件

- Docker和Docker Compose
- Python 3.11+(用于本地开发/测试)
- 紫外线 (Python包管理器)

## 快速开始

1. **启动服务**:```bash
docker compose up -d
  1. 等待初始化 (大约需要30秒):```bash
    docker compose logs -f keycloak-init

init服务会自动配置Keycloak并将凭据写入 `.env`.

1. **使用预先生成的令牌进行测试**:```bash
uv run python client.py
  1. 使用完整的OAuth流程进行测试:```bash
    uv run python oauth_client.py http://localhost:9000

## 配置

### 默认凭据

|设置|值|
|---------|-------|
|领域| `mcp` |
|客户端ID| `mcp-server` |
|测试用户| `user` / `password` |
|管理控制台|http://localhost:9090 (`admin` / `admin`) |

### 环境变量

这 `keycloak-init` 服务创建了一个 `.env` 文件包含:

|变量|描述|
|----------|-------------|
| `KEYCLOAK_CLIENT_ID` |OAuth客户端ID|
| `KEYCLOAK_CLIENT_SECRET` |OAuth客户端密钥(自动生成)|
| `MCP_TOKEN` |预先生成的JWT访问令牌用于测试|

### 服务器环境变量

|变量|默认值|描述|
|----------|---------|-------------|
| `KEYCLOAK_URL` | `http://localhost:9090` |JWKS的内部密钥斗篷URL|
| `KEYCLOAK_PUBLIC_URL` | `http://nginx:80` |通过nginx创建密钥斗篷URL|
| `KEYCLOAK_REALM` | `mcp` |Keycloak领域名称|
| `KEYCLOAK_CLIENT_ID` | `mcp-server` |OAuth客户端ID|

## 用法

### 选项1:直接令牌身份验证

使用来自的预生成令牌 `.env`:```python
import asyncio
from fastmcp import Client
from dotenv import load_dotenv
import os

load_dotenv()

async def main():
async with Client(
"http://localhost:9000/mcp",
auth=os.getenv("MCP_TOKEN"),
) as client:
tools = await client.list_tools()
print("Tools:", [t.name for t in tools])

result = await client.call_tool("hello", {"name": "World"})
print(result.content[0].text)

asyncio.run(main())

选项2:完整的OAuth流程

运行执行完整授权代码流的OAuth客户端:```bash
uv run python oauth_client.py http://localhost:9000


这将:

1. 发现OAuth端点
1. 注册为动态客户端
1. 打开浏览器进行用户登录(使用 `user` / `password`)
1. 代币的交换授权码
1. 使用访问令牌调用MCP工具

## 接触互联网(ngrok)

要与外部客户端一起使用或测试来自不同来源的OAuth流:

1. **开始ngrok**:```bash
ngrok http 9000
  1. 使用ngrok URL进行测试:```bash
    uv run python oauth_client.py https://your-subdomain.ngrok-free.app

服务器自动检测来自的公共URL `X-Forwarded-*` 并相应地调整所有OAuth URL。

## 端点

|端点|描述|
|----------|-------------|
| `/mcp` |MCP服务器(可流式传输http)|
| `/.well-known/oauth-authorization-server` |OAuth服务器元数据|
| `/.well-known/oauth-protected-resource/mcp` |受保护的资源元数据|
| `/authorize` |OAuth授权端点|
| `/token` |OAuth令牌端点|
| `/register` |动态客户端注册|
| `/realms/mcp/...` |Keycloak OIDC端点(代理)|
| `/debug` |显示请求标头的调试端点|

## MCP工具

服务器提供了两个示例工具:

- **你好(姓名:str)**:返回问候语(`hello, {name}`)
- **add(a:int,b:int)**:将两个数字相加

## 项目结构```
.
├── docker-compose.yml    # Service orchestration
├── Dockerfile            # MCP server container
├── nginx.conf            # Reverse proxy configuration
├── server.py             # FastMCP server with DynamicOIDCProxy
├── client.py             # Simple test client (uses pre-generated token)
├── oauth_client.py       # Full OAuth flow test client
├── setup_keycloak.py     # Keycloak configuration script
├── realm-export.json     # Keycloak realm import config
├── pyproject.toml        # Python dependencies
└── .env                  # Generated credentials (gitignored)

发展

本地设置```bash

Install dependencies

uv sync

Run server locally (requires Keycloak running in Docker)

uv run python server.py


### 重建MCP服务器```bash
docker compose build mcp-server
docker compose up -d mcp-server

查看日志```bash

All services

docker compose logs -f

Specific service

docker compose logs -f mcp-server
docker compose logs -f keycloak


### 重置所有内容```bash
docker compose down -v
rm -f .env
docker compose up -d

运作原理

动态OIDC代理

服务器使用自定义 DynamicOIDCProxy 扩展FastMCP的类 OIDCProxy 要支持动态URL,请执行以下操作:

  1. 动态URL检测:从中提取公共URL X-Forwarded-Proto 和 X-Forwarded-Host 标头
  2. URL重写中间件:在响应中将内部URL(nginx、keycloak、localhost)重写为公共URL
  3. 动态代币交换:使用检测到的公共URL进行OAuth令牌交换redirect_uri
  4. 灵活的令牌验证:跳过发行者验证,以支持使用不同公共URL发行的令牌

OAuth流

  1. 客户端从以下位置发现OAuth端点 /.well-known/oauth-authorization-server
  2. 客户端通过以下方式动态注册 /register
  3. 客户端将用户重定向到 /authorize PKCE挑战
  4. 用户使用Keycloak进行身份验证
  5. Keycloak重定向回MCP服务器 /auth/callback
  6. MCP服务器与Keycloak交换代码并发出FastMCP JWT
  7. 客户端通过以下方式交换FastMCP令牌的授权码 /token
  8. 客户端使用访问令牌调用MCP工具

故障排除

“不记名代币被拒绝”

  • 检查Keycloak是否正常: docker compose ps
  • 查看令牌验证日志: docker compose logs mcp-server
  • 服务器跳过颁发者验证以获得动态URL支持

“无效的redirect_uri”

  • 确保realm-export.json具有 "redirectUris": ["*"]
  • 更改后重建: docker compose down -v && docker compose up -d

“连接被拒绝”

  • 等待所有服务启动: docker compose ps
  • 检查Keycloak健康状况: curl http://localhost:9090/health

与ngrok的代币交换失败

  • 确保nginx正在转发X-Forwarded标头
  • 检查调试终结点: curl https://your-ngrok-url/debug

安全说明

  • 默认配置使用开发设置(无SSL,简单密码)
  • 生产:
  • 通过nginx启用HTTPS
  • 使用强凭据
  • 考虑使用固定的公共URL启用颁发者验证
  • 查看Keycloak安全设置
  • 这 .env 文件包含机密,不应提交

许可证

麻省理工学院

常见问题

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

在客户端按下面的安装命令接入:uv run python client.py。装完在客户端配置里引用同一个包或端点。

self hosted oauth MCP 怎么在客户端里配置?

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

self hosted oauth MCP 收费吗?

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

self hosted oauth MCP 需要 API Key 吗?

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

self hosted oauth MCP 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 自托管、Python、安全。具体工具清单以官方文档为准。

self hosted oauth MCP 需要什么运行环境?

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

self hosted oauth MCP 是本地还是远程?

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

热门专题

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

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