公告MCP命令行AI 智能体TinyShield

TinyShield 现已支持 MCP 服务器和命令行

让 Claude Code、Codex 等 AI 智能体和你自己的脚本查看哪些 App 连接到了哪里、处理 Require Approval 请求并管理 Block List。TinyShield PRO 功能。

🤖产品团队

TinyShield 现在内置了 MCP 服务器和命令行工具。

Claude Code、Codex、Cursor 等 AI 智能体,以及你自己写的脚本,现在都能查看哪些 App 连接到了哪里、处理 Require Approval 请求,并管理 Block List、Allow List 和连接模式。一切都只在你的 Mac 上进行。

在本文中,你将了解:

  • 我们为什么开发这项功能
  • AI 智能体能用 TinyShield 做什么
  • 如何将 TinyShield 添加到 Claude Code、Codex 和 Cursor
  • 如何使用 tinyshield 命令行
  • TinyShield 如何保障安全

我们为什么开发这项功能

Require Approval 会为每个新 App 询问你一次。你在 Mac 前时,这是最合适的默认设置。

但 AI 智能体整天都在创建和运行新工具:新的 Python、包管理器、构建工具。对 TinyShield 来说,每一个都是新 App,所以每一个都要等待批准。如果智能体在后台工作,或者你不在 Mac 前,就没人看到弹窗。下载只会超时,智能体也不知道原因。

一位 TinyShield 用户希望能通过智能体或脚本处理这种情况(issue #103)。现在,你的智能体可以查看哪些 App 正在等待批准,并在你同意后允许它们。

AI 智能体能用 TinyShield 做什么?

MCP 服务器提供 32 个工具。借助它们,你的智能体可以:

  • 查看活动:哪些 App 使用了网络、它们访问的域名和 IP 地址、所在国家/地区,以及与 TinyShield 主窗口相同的树状视图。
  • 处理 Require Approval:列出等待批准的 App,允许或阻止它们,或者等待下一个。
  • 管理决定:列出你的 App Connection Decisions,修改它们,或将其删除,让 TinyShield 重新询问。
  • 编辑列表:在 Block List 和 Allow List 中添加或删除域名、IP 地址和 App。
  • 切换连接模式:Allow All、Require Approval 或 Block All。
  • 查看带宽:每个 App 在过去 5 分钟、1 小时、1 天、1 周或 1 个月的流量使用,以及实时流量。
  • 管理设置:更改设置、导出或导入配置,以及打开 TinyShield 窗口。

直接用中文提问即可:

  • “我的 npm install 超时了,是不是 TinyShield 在等待批准?”
  • “过去一小时有哪些 App 联网了?分别连到了哪里?”
  • “阻止 ads.example.com,以及 tracker.net 的所有子域名。”
  • “这周哪个 App 用的流量最多?”

开启 MCP & Command Line

  1. 打开 TinyShield,前往 Settings → MCP。
  2. 开启 Enable MCP & Command Line。
  3. 状态会显示 Running on 127.0.0.1 和端口号。

MCP & Command Line 是 TinyShield PRO 功能,在你手动开启之前一直处于关闭状态。如需升级,请查看价格方案。

将 TinyShield 添加到你的 AI 智能体

Settings → MCP → MCP Configuration 中有 Claude Code、Codex 和 Manual 三个标签页,每个都带有 Copy 按钮。以下是其中显示的命令:

Claude Code

claude mcp add --scope user tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"

Codex

codex mcp add tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"

Cursor 和其他 MCP 客户端

选择 Manual,然后将以下内容添加到客户端的 MCP 配置中:

{
  "mcpServers": {
    "tinyshield": {
      "command": "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
    }
  }
}

启动智能体并不会打开 TinyShield。智能体首次使用工具时,TinyShield 才会在后台启动,不显示任何窗口。

提示:如果 TinyShield 不在“应用程序”文件夹中,请从 Settings → MCP 复制命令,其中的路径始终适用于你的 Mac。

使用命令行

命令行工具是 App 内置的 tinyshield-cli。Settings → MCP → Command Line 中会显示一个别名,可添加到 shell 配置文件(例如 ~/.zshrc)中:

alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'

打开一个新的终端窗口,然后试试:

# 版本、许可证、连接模式和各列表的条目数
tinyshield status

# 切换到 Require Approval
tinyshield mode require-approval

# 等待批准的 App,以及它们尝试连接的地址
tinyshield pending list

# 允许其中一个(按名称、bundle ID、路径或 pid)
tinyshield pending allow /opt/homebrew/bin/uv

# 阻止一个域名,以及另一个域名的所有子域名
tinyshield block-list add ads.example.com '*.tracker.net'

# 过去一小时内被阻止的 App
tinyshield apps --range 1h --status blocked

# 过去一小时内 Chrome 连接了哪里
tinyshield connections "Google Chrome" --range 1h

# Safari 本周的流量使用
tinyshield bandwidth --timeframe week --app Safari

输出如下:

❯ tinyshield block-list add ads.example.com '*.tracker.net'
Added to the Block List: ads.example.com, *.tracker.net. The Block List is on.

运行 tinyshield --help 可查看所有命令。每条命令调用的都是智能体通过 MCP 使用的同一个工具,而 tinyshield call <tool> '<json>' 可以调用其中任意一个。

在脚本中使用

在任意命令后加上 --json,即可输出脚本可读取的格式。退出码会告诉脚本发生了什么:

退出码含义
0成功。
1命令执行失败。
3未找到。
4需要 TinyShield PRO。
69无法连接 TinyShield:MCP & Command Line 已关闭,或未安装该 App。

例如,tinyshield pending wait 会一直等到有 App 需要批准,然后显示它。如果超时前没有 App 请求批准,它会以退出码 3 结束,这样脚本就可以循环等待或通知你:

# 最多等待 10 分钟,直到出现需要批准的新 App
tinyshield pending wait --timeout 600 --only-new

安全设计

TinyShield 守护着你的 Mac,因此我们让它保持安全,并始终由你掌控:

  • 默认关闭:在你开启 Enable MCP & Command Line 之前,不会监听任何连接。
  • 仅限本机:服务器只接受来自你 Mac 本机(127.0.0.1)的连接。每次调用都需要访问令牌,该令牌只有你的用户账户能读取,并且服务器每次启动时都会更换。Regenerate Access Token 可随时生成新令牌,智能体和脚本会自动获取。
  • 拒绝网站访问:TinyShield 会拒绝来自网页浏览器的请求,因此网站无法与它通信。
  • 与点按遵循相同规则:智能体所做的更改,与你在 TinyShield 中点按操作走的是同一条路径,并会立即显示在已打开的窗口中。
  • 谁做了什么,一目了然:由智能体或脚本做出的决定,会在 Decisions list 中显示来源,例如 Claude Code via MCP 或 Command Line。Settings → MCP → Recent Activity 会列出每一次调用。
  • 智能体会先问你:TinyShield 要求智能体在允许未知 App、切换到 Allow All、删除规则、导入配置或清除数据之前先征得你的同意,并且优先只允许单个 App,而不是更改模式。

开始使用

  1. 将 TinyShield 更新到最新版本,或下载 TinyShield。
  2. 打开 Settings → MCP,开启 Enable MCP & Command Line(TinyShield PRO)。
  3. 复制适用于 Claude Code 或 Codex 的命令,然后问你的智能体:“TinyShield 是不是在等待批准?”

不只是 TinyShield:同一团队开发的 Proxyman、TCP Viewer 和 Device MCP,现在也都有了 MCP 服务器和命令行。阅读公告。

对新工具或新命令有想法?欢迎在 GitHub 上告诉我们。

准备好保护你的 Mac 了吗?

体验 TinyShield 强大的网络监控与防护能力,在保持最佳性能的同时让 Mac 远离威胁。

下载 TinyShield