安全攻防
evening
FastMCP OpenAPI 路径穿越到认证 SSRF 复现与分析
2026-11-16
1 阅读
约10分钟阅读
先知社区
字号:
本文复现并分析 FastMCP OpenAPIProvider 的一个路径穿越漏洞:它把 OpenAPI 规范里的接口自动变成 MCP 工具暴露给客户端,但拼串口 URL 时路径参数未做 URL 编码,又会解析 ../ 的 urllib.parse.urljoin() 。 MCP 客户端在一个本该是 user_id 的参数里塞 ../ ,可以逃出规范划定的接口范围,带着提供者配好的鉴权头去请求协议任何路径——官方定性为认证上下文下的SSRF。下面在本地起测试环境通讯 + MCP 服务端,打通整条链,漏洞漏洞版 3.1.0 与修复版 3.2.0 做对比。 一、漏洞说明 Advisory 链接: https://github.com/PrefectHQ/fastmcp/security/advisories/GHSA-vv7q-7jx5-f767 FastMCP 的OpenAPIProvider 用来把一个 OpenAPI 规范里声明的监听接口,自动生成生成一个 MCP 工具,排序 MCP 客户端(通常是大模型/代理)调用。负责拼最终请求的是 RequestDirector 类。问题出在它的 _build_url() :当接口带路径参数(如 /api/v1/users/{user_id} )时,它把参数值直接替换进模板字符串,不做任何 URL 编码,并且用urllib.parse.urljoin() 解析出最终的 URL。 urljoin() 接 ../ 当目录成上跳。于是一个控制了路径参数的攻击者,用路径逃出规范本该限定的接口远端可以,去请求端上任何接口。由于这些请求的是提供者为一方配置的鉴权头(如 Authorization: Bearer ... ),攻击者相当于有一个服务端的设备去敲规范里根本没有调用的内部接口——这就是认证下部的内部接口SSRF。OpenAPIProvider利用“只暴露规范里那几个接口”来当安全边界,被一个../彻底绕过。二、基本信息公开时间2026-03-31编号GHSA-vv7q-7jx5-f767类型威胁路径穿越→认证SSRF(CWE-918)严重程度高利用条件能驱动OpenAPI生成的MCP工具调用、控制路径参数三、版本fastmcp < 3.2.0 , 3.2.0 修复。任何用 OpenAPIProvider / FastMCP.from_openapi() 把带路径参数的网关接口暴露成 MCP 工具的配置都在范围内。 四、影响组件 FastMCP(PrefectHQ/fastmcp)是目前使用最广泛的 MCP(Model Context Protocol)Python 框架之一, from_openapi 是它把现成的 REST 仓库一键接入 MCP MCP 封装连接大模型/Agent 与外部工具、数据源的协议,“把接口接口自动变成工具”是 Agent 时代很常见的接入方式,这也让这类自动封装的电信边界问题影响面不小。 五、使用条件服务端用 OpenAPIProvider / FastMCP.from_openapi() 暴露了带路径参数的接口( /x/{id} 形式); fastmcp 版本 < 3.2.0 ;攻击者能驱动这个 MCP 工具的调用——可以是直接连 MCP 服务端的客户端,也可以是一个被提示词注入带偏的大模型/代理;提供商配置了对实验室的鉴权(穿越后的请求会继承协议,直至完成);室内上存在规范外部、值得一打的接口(内部管理、结构、可写等操作)。六、环境搭建 1、环境拓扑本机 127.0.0.1 ├──工作室服务 backend.py (uvicorn, 127.0.0.1:8930) │ ├── GET /api/v1/users/{user_id} 对外接口(会写进 OpenAPI 规范) │ └── GET /internal/admin/secrets 内部接口(不规范,需 Bearer 凭据) └── Attack.py FastMCP.from_openapi(仅声明 users 接口) + MCP 客户端 └── 出站 httpx 客户端带 授权:不记名 svc-internal-token 2、建两个隔离 venv(漏洞版 / 修复版) 库类漏洞用 venv 锁版本最轻、最稳定: python3 -m venv .venv-vuln . .venv-vuln/bin/activate && pip install "fastmcp==3.1.0" fastapi uvicorn && 停用 python3 -m venv .venv-fixed 。 .venv-fixed/bin/activate && pip install "fastmcp==3.2.0" fastapi uvicorn && deactivate 3、欠款服务 backend.py 一个外部接口、一个带欠的内部接口,模拟腰带: from fastapi import FastAPI, Header, HTTPException import uvicorn app = FastAPI() ADMIN_TOKEN = "Bearer svc-internal-token" # MCP provider 配给欠款的内部接口@app.get("/api/v1/users/{user_id}") def get_user(user_id: str): return {"endpoint": "public", "user_id": user_id} @app.get("/internal/admin/secrets") def admin_secrets(authorization: str = Header(default="")): 如果授权!= ADMIN_TOKEN: raise HTTPException(status_code=401, Detail="unauthorized") return {"endpoint": "INTERNAL-ADMIN", "db_password": "p@ss", "api_keys": ["sk-xxx"]} if __name__ == "__main__": uvicorn.run(app, host="127.0.0.1", port=8930, log_level="warning") 4、MCP 服务端 + 客户端 Attack.py import asyncio, httpx, fastmcp from fastmcp import FastMCP, Client BACKEND = "http://127.0.0.1:8930" ADMIN_TOKEN = "Bearer svc-internal-token" OPENAPI = { "openapi": "3.1.0", "info": {"title": "user-service", "version": "1.0"}, "paths": {"/api/v1/users/{user_id}": {"get": { "operationI
这篇文章对您有帮助吗?
订阅66必读
每日精选科技资讯,直达你的邮箱