MCP Auth Server

MCP安全风控

提供方 christian-posta

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

一个基于FastAPI构建的MCP服务器,支持JWT认证、OAuth 2.0元数据端点、基于范围的和基于角色的访问控制。

一句话选型结论

按资料字段整理

MCP Auth Server 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

认证服务Python本地部署JWTOAuth2.0FastAPI访问控制

安装与配置

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

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

MCP逐步认证

此存储库演示了如何通过迭代步骤构建具有HTTP传输和JWT身份验证的MCP(模型上下文协议)服务器。

此回购是关于“MCP授权”的深入、循序渐进的博客文章的伴侣。请参阅以下内容:

  • 了解MCP授权,一步一步,第一部分
  • 了解MCP授权,循序渐进,第二部分
  • 了解MCP授权,循序渐进,第三部分

第4部分(本系列的后期补充):
MCP授权与动态客户端注册

MCP授权规范要求

下表显示了主要身份提供者对MCP授权规范所需的OAuth RFC的支持。

RFC要求摘要:

  • PKCE:用于代码交换的证明密钥(OAuth 2.1要求)
  • RFC 8414:OAuth 2.0授权服务器元数据
  • RFC 7591:OAuth 2.0动态客户端注册协议
  • RFC 8707:OAuth 2.0的资源指标

标识提供者 · PKCE · RFC 8414 · RFC 7591 · RFC 8707
Okta · 是 · 是 · 是 · N0
身份验证0 · 是 · 是 · 有点 · 没有
钥匙斗篷 · 是 · 是 · 是 · 否
平联邦 · 是 · 是 · 是
ForgeRock · 是的 · 是的 · 有点
谷歌OAuth · 是 · 否 · 否 · 不
微软Entra · 是 · 是 · 否 · 否

概述

该项目展示了如何使用以下工具构建安全的MCP服务器:

  • 基于FastAPI的HTTP传输
  • JWT令牌身份验证
  • OAuth 2.0元数据端点
  • 基于范围的授权
  • 基于角色的访问控制

循序渐进

第一步:FastAPI基本框架

  • 文件: http-transport-steps/src/mcp_http/step1.py
  • 它添加了什么:具有健康端点的基本FastAPI应用程序
  • 主要特点:
  • FastAPI服务器设置
  • 基本健康检查终点(/health)
  • MCP HTTP传输基础

步骤2:基本MCP请求处理

  • 文件: http-transport-steps/src/mcp_http/step2.py
  • 它添加了什么:MCP协议请求/响应处理
  • 主要特点:
  • MCP请求解析和验证
  • 基本MCP响应结构
  • /mcp MCP协议通信端点
  • JSON-RPC风格的请求处理

步骤3:MCP工具和提示定义

  • 文件: http-transport-steps/src/mcp_http/step3.py
  • 它添加了什么:MCP工具和提示,无需调度
  • 主要特点:
  • 工具定义(echo, get_time)
  • 快速定义(greeting, help)
  • 工具和提示的MCP协议合规性
  • 尚未实际执行工具

步骤4:MCP工具调度

  • 文件: http-transport-steps/src/mcp_http/step4.py
  • 它添加了什么:实际工具执行和及时处理
  • 主要特点:
  • 工具调度和执行
  • 及时检索和处理
  • 使用功能工具运行MCP服务器
  • 无效请求的错误处理

第五步:JWT基础设施

  • 文件: http-transport-steps/src/mcp_http/step5.py
  • 它添加了什么:JWT公钥加载和JWKS端点
  • 主要特点:
  • 从文件加载公钥
  • JWKS(JSON Web密钥集)端点(/.well-known/jwks.json)
  • 外部令牌生成脚本(generate_token.py)
  • 智威汤逊基础设施基础

步骤6:JWT令牌验证

  • 文件: http-transport-steps/src/mcp_http/step6.py
  • 它添加了什么:JWT身份验证中间件和实施
  • 主要特点:
  • JWT令牌验证中间件
  • 身份验证强制执行 /mcp 端点
  • 从令牌中提取用户上下文
  • 对无效/丢失令牌的正确错误响应

步骤7:OAuth 2.0元数据端点

  • 文件: http-transport-steps/src/mcp_http/step7.py
  • 它添加了什么:受保护资源和授权服务器的OAuth 2.0元数据
  • 主要特点:
  • /.well-known/oauth-protected-resource 端点
  • /.well-known/oauth-authorization-server 端点
  • 使用OAuth元数据增强健康端点
  • MCP响应中的OAuth元数据

步骤8:基于范围的授权

  • 文件: http-transport-steps/src/mcp_http/step8.py
  • 它添加了什么:权限检查和基于角色的访问控制
  • 主要特点:
  • check_permission 范围验证方法
  • 基于角色的访问控制(管理员、用户、访客)
  • 403权限不足的禁止响应
  • MCP操作的范围执行

步骤9:增强MCP集成(计划中)

  • 它将添加什么:响应和经过身份验证的工具中的用户上下文
  • 计划的功能:
  • MCP响应标头/元数据中的用户上下文
  • 具有用户感知行为的经过身份验证的工具
  • 增强的MCP协议集成
  • 基于用户身份的个性化响应

JWT令牌结构

JWT代币包括:

  • 用户ID:用户的唯一标识符
  • 范围:权限(例如。, mcp:read, mcp:tools, mcp:prompts)
  • 角色:用户角色(例如。, admin, user, guest)
  • 过期:令牌有效期

测试

每个步骤都包括一个相应的测试脚本(test_stepX.sh)这验证了:

  • 基本功能
  • JWT身份验证(步骤5+)
  • 授权(步骤6+)
  • OAuth元数据(步骤7+)
  • 访问控制(步骤8+)

用法

先决条件

  1. 安装 uv: https://docs.astral.sh/uv/getting-started/installation/
  2. 导航到 http-transport-steps 目录

紫外线下的跑步步骤```bash

Run any step using uv run

uv run step1
uv run step2
uv run step3

... etc


### 使用环境配置运行步骤10

步骤10支持Keycloak和MCP服务器URL的基于环境的配置。您可以使用 `--env` 标志,或默认为 `keycloak_direct.env`.

提供了两个示例env文件:

- `keycloak_direct.env` (如需直接进入Keycloak,请访问 `localhost:8080`)
- `keycloak_proxy.env` (如需代理访问,请访问 `localhost:9090`)

**示例用法:**```bash
# Run step 10 with a specific env file (e.g., proxy)
uv run step10 --env keycloak_proxy.env

如果缺少env文件或环境变量,服务器将恢复到合理的默认值(localhost:8080等)。

运行步骤11的注意事项

  • 您需要运行step10-mcp服务器
  • 您必须允许匿名客户端注册:
  • 添加受信任的主机(检查密钥斗篷日志以获取正确的IP)
  • 对于受信任的主机策略,您不需要在URI上进行匹配
  • mcp的允许范围:读取等和aud映射器
  • 然后运行step11客户端```bash
    uv run step11

与mcp检查员一起运行

- 您需要使用config.yaml运行agentgateway
- uv运行步骤10-env密钥斗篷proxy.env
- 运行mcp-inspector UI(注意,一些auth东西坏了,现在,使用这个:https://github.com/christian-posta/mcp-inspector/tree/ceposta-patches)
- 然后按照一步一步的身份验证流程进行操作

mcp范围问题:
https://github.com/modelcontextprotocol/inspector/issues/587

### 令牌生成

对于需要JWT身份验证的步骤5-8,您可以使用 `generate_token.py` 脚本:```bash
uv run python generate_token.py --username alice --scopes mcp:read,mcp:tools
uv run python generate_token.py --username bob --scopes mcp:read,mcp:prompts
uv run python generate_token.py --username admin --scopes mcp:read,mcp:tools,mcp:prompts
uv run python generate_token.py --username guest --scopes ""

Keycloak令牌生成

要快速获得测试步骤9/keycloak的令牌:```bash# Get token for admin user (full access)
curl -X POST "http://localhost:8080/realms/mcp-realm/protocol/openid-connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=password" \
-d "client_id=mcp-test-client" \
-d "username=mcp-admin" \
-d "password=admin123" \
-d "scope=openid profile email mcp:read mcp:tools mcp:prompts" | jq -r '.access_token'

```

该脚本将输出一个JWT令牌,可用于 Authorization: Bearer 经过身份验证的请求的标头。

依赖项

  • 快速 API
  • PyJWT
  • 密码学
  • 优维康

该项目使用 uv 用于依赖关系管理 pyproject.toml 配置。

常见问题

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

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

MCP Auth Server 怎么在客户端里配置?

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

MCP Auth Server 收费吗?

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

MCP Auth Server 需要 API Key 吗?

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

MCP Auth Server 能提供哪些能力?

资料显示能力标签包括 认证服务、访问控制、Python、FastAPI。具体工具清单以官方文档为准。

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

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

MCP Auth Server 是本地还是远程?

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

热门专题

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

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