Airlock MCP

MCP安全风控

提供方 JosephRedes · 包名 airlock-mcp

安全风控 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

Airlock-MCP是一个安全优先的MCP协议透传代理,可在AI主机和MCP服务器之间执行可配置的安全策略,包括工具允许列表、危险命令拦截、路径范围限制等功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

AI安全TypeScript本地部署代理服务访问控制数据保护协议拦截

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx airlock-mcp --config airlock.config.json

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

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

服务器档案

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

详细介绍

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

气锁MCP

安全第一传递代理 模型上下文协议Airlock位于您的AI主机(VS Code、Claude Desktop)和任何MCP服务器之间,在转发请求之前执行可配置的安全策略。```
AI Host (VS Code / Claude Desktop)
|
v
[ Airlock-MCP ] <-- security checks run here
|
v
Target MCP Server (filesystem, database, API, etc.)


## 为什么

MCP服务器可以公开强大的工具——文件系统访问、shell执行、数据库查询。Airlock允许您在不授予AI无限制访问权限的情况下运行它们:

- **允许使用的工具** 按名称-默认情况下拒绝其他所有内容
- **阻挡危险的贝壳图案** 在它们到达服务器之前
- **作用域文件系统访问** 到特定目录
- **速率限制** 全局或按工具调用工具
- **拒绝超大有效载荷** 在他们击中目标之前
- **修改个人身份信息** 从到达模型之前的响应中

所有检查都按顺序运行,具有故障保护功能,每个决定都会被记录下来。

______________________________________________________________________

## 安装```bash
npm install -g airlock-mcp

或者在不安装的情况下运行:```bash
npx airlock-mcp --config airlock.config.json


______________________________________________________________________

## 快速开始

**1.创建 `airlock.config.json`:**```json
{
&quot;targetCommand&quot;: &quot;npx&quot;,
&quot;targetArgs&quot;: [&quot;-y&quot;, &quot;@modelcontextprotocol/server-filesystem&quot;, &quot;/home/user/projects&quot;],
&quot;allowedTools&quot;: [&quot;read_file&quot;, &quot;list_directory&quot;, &quot;search_files&quot;],
&quot;allowedPaths&quot;: [&quot;/home/user/projects&quot;],
&quot;blockDangerousCommands&quot;: true,
&quot;logging&quot;: { &quot;level&quot;: &quot;info&quot;, &quot;destination&quot;: &quot;stdout&quot; }
}

2.将AI主机指向Airlock (参见 主机集成 在......下面


主机集成

VS代码(副驾驶/MCP扩展)

在 .vscode/mcp.json 或用户 settings.json:```json
{
"mcpServers": {
"secure-filesystem": {
"command": "npx",
"args": ["airlock-mcp", "--config", "/absolute/path/to/airlock.config.json"]
}
}
}


### 克劳德桌面

在 `claude_desktop_config.json`:```json
{
&quot;mcpServers&quot;: {
&quot;secure-filesystem&quot;: {
&quot;command&quot;: &quot;npx&quot;,
&quot;args&quot;: [&quot;airlock-mcp&quot;, &quot;--config&quot;, &quot;/absolute/path/to/airlock.config.json&quot;]
}
}
}

安全检查

每个 tools/call 请求按顺序通过这些检查。任何步骤的失败都会返回错误,并且请求永远不会被转发。

# 检查 配置字段 默认值
1 工具列表 allowedTools 否认一切
2 危险的命令模式 blockDangerousCommands 已启用
3 路径范围 allowedPaths 允许所有
4 速率限制 rateLimiting 残疾人
5 请求大小 sizeLimits 残疾人
6 响应大小 sizeLimits 残疾人
7 PII编辑 piiRedaction 残疾人

resources/read 根据以下内容检查请求 allowedResources (种类前缀allowlist)。


配置参考

目标服务器

正是其中之一 targetCommand 或 targetUrl 是必需的。```jsonc
{
// Spawn a local MCP server over stdio
"targetCommand": "npx",
"targetArgs": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
"targetEnv": { "MY_VAR": "value" }, // optional env vars for the child process

// OR connect to a remote HTTP MCP server
"targetUrl": "https://my-mcp-server.example.com"
}


______________________________________________________________________

### 工具列表```jsonc
{
// Only these tools are forwarded. Everything else is blocked.
// Empty array (the default) blocks all tools.
&quot;allowedTools&quot;: [&quot;read_file&quot;, &quot;list_directory&quot;, &quot;search_files&quot;]
}

资源分配表```jsonc

{
// resources/read URIs must start with one of these prefixes.
// Empty array (the default) blocks all resources.
"allowedResources": ["mcp://public/", "mcp://logs/"]
}


______________________________________________________________________

### 路径范围```jsonc
{
// Tool arguments containing filesystem paths must resolve inside one
// of these directories. URL-encoding is decoded and symlinks are
// followed before checking, so traversal tricks don&#x27;t work.
// Empty array (the default) skips path checking entirely.
&quot;allowedPaths&quot;: [&quot;/home/user/projects&quot;, &quot;/tmp/workspace&quot;]
}

危险指令封锁```jsonc

{
// Scan tool arguments for shell operators and dangerous commands:
// &&, pipes, semicolons before rm/sudo/curl/etc., backticks, $().
// Default: true
"blockDangerousCommands": true
}


______________________________________________________________________

### 速率限制

默认情况下禁用。使用滑动窗口-时间戳早于 `windowMs` 每张支票上都有修剪。被阻止的请求不消耗配额。```jsonc
{
&quot;rateLimiting&quot;: {
&quot;enabled&quot;: true,
&quot;windowMs&quot;: 60000,       // sliding window in ms (default: 60 000)
&quot;maxRequests&quot;: 100,      // max allowed calls per window, globally

// Per-tool overrides - inherits global windowMs/maxRequests if omitted
&quot;perTool&quot;: {
&quot;write_file&quot;: { &quot;maxRequests&quot;: 10 },
&quot;execute_command&quot;: { &quot;windowMs&quot;: 10000, &quot;maxRequests&quot;: 3 }
}
}
}

有效载荷大小限制

默认情况下禁用。请求大小以JSON序列化参数的UTF-8字节长度来衡量。响应大小是所有值的总和 text 内容项。```jsonc
{
"sizeLimits": {
"enabled": true,
"maxRequestBytes": 1048576, // 1 MB (default)
"maxResponseBytes": 10485760 // 10 MB (default)
}
}


______________________________________________________________________

### PII编辑

默认情况下禁用。扫描工具和资源响应文本,并用键入的占位符替换匹配项,如 `[SSN:REDACTED]`.```jsonc
{
&quot;piiRedaction&quot;: {
&quot;enabled&quot;: true,

// Optional: list specific patterns to apply.
// Omit to use the default set (marked below).
&quot;patterns&quot;: [&quot;ssn&quot;, &quot;credit_card&quot;, &quot;api_key&quot;, &quot;email&quot;]
}
}

可用图案:

模式 检测 默认打开
ssn 美国社会保障号码 是
credit_card 信用卡/借记卡号码 是
bank_account 银行账号(靠近关键字) 否
api_key API密钥和令牌(sk-, pk-等) 是
aws_key AWS访问密钥ID(AKIA...) 是的
password 配置/日志格式的密码 是
private_key PEM私钥块 是
jwt JSON Web令牌 是
connection_string 数据库连接字符串 是
email 电子邮件地址 是
phone 电话号码 否
ip_address IPv4地址 否
iban 国际银行账号 否
swift SWIFT/BIC代码 否
internal_url 内部/公司/临时网址 否

日志记录```jsonc

{
"logging": {
"level": "info", // "debug" | "info" | "warn" | "error"
"destination": "stdout", // "stdout" | "file"
"filePath": "/var/log/airlock.log" // required when destination is "file"
}
}


日志的结构为JSON(皮诺).安全决策(允许/拒绝)记录在 `info` 或 `warn` 审计级别。

______________________________________________________________________

## 完整示例配置```json
{
&quot;targetCommand&quot;: &quot;npx&quot;,
&quot;targetArgs&quot;: [&quot;-y&quot;, &quot;@modelcontextprotocol/server-filesystem&quot;, &quot;/home/user/projects&quot;],
&quot;allowedTools&quot;: [
&quot;read_file&quot;,
&quot;write_file&quot;,
&quot;list_directory&quot;,
&quot;search_files&quot;
],
&quot;allowedResources&quot;: [&quot;mcp://public/&quot;],
&quot;allowedPaths&quot;: [&quot;/home/user/projects&quot;],
&quot;blockDangerousCommands&quot;: true,
&quot;rateLimiting&quot;: {
&quot;enabled&quot;: true,
&quot;windowMs&quot;: 60000,
&quot;maxRequests&quot;: 200,
&quot;perTool&quot;: {
&quot;write_file&quot;: { &quot;maxRequests&quot;: 20 }
}
},
&quot;sizeLimits&quot;: {
&quot;enabled&quot;: true,
&quot;maxRequestBytes&quot;: 1048576,
&quot;maxResponseBytes&quot;: 10485760
},
&quot;piiRedaction&quot;: {
&quot;enabled&quot;: true,
&quot;patterns&quot;: [&quot;api_key&quot;, &quot;password&quot;, &quot;private_key&quot;, &quot;jwt&quot;, &quot;connection_string&quot;]
},
&quot;logging&quot;: {
&quot;level&quot;: &quot;info&quot;,
&quot;destination&quot;: &quot;stdout&quot;
}
}

安全设计原则

  • 默认情况下拒绝 -空的 allowedTools 或 allowedResources 阻止一切
  • 无信息披露 -被阻止的工具错误不会显示满列表
  • 故障保险 -任何验证错误都会阻止请求;什么都不会掉下来
  • 被阻止的请求没有配额消耗 -费率限制预算仅用于转接呼叫
  • 启动时验证配置 通过Zod-代理不会以无效的配置启动

发展```bash

npm install
npm run dev -- --config airlock.config.json # run with ts-node (no build needed)
npm run build # compile TypeScript -> dist/
npm test # unit tests (vitest)
npm run test:watch # watch mode
npm run test:integration # integration tests (spawns processes)
npm run typecheck # type check without emitting


要运行单个测试文件,请执行以下操作:```bash
npx vitest run src/test/guard.test.ts

许可证

麻省理工学院

常见问题

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

在客户端按下面的安装命令接入:npx airlock-mcp --config airlock.config.json。对应的包名是 airlock-mcp。装完在客户端配置里引用同一个包或端点。

Airlock MCP 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Airlock MCP 收费吗?

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

Airlock MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Airlock MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Airlock MCP 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 安全、代理服务、TypeScript、Claude、访问控制。具体工具清单以官方文档为准。

Airlock MCP 需要什么运行环境?

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

Airlock MCP 是本地还是远程?

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

热门专题

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

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