S
sunglasses-dev/sunglasses
Open source input firewall for AI agents, beta.
★ 11·更新 2026-11-17
在 GitHub 查看 ↗直链 · 无中转页
我们没有可直接复制的安装命令,也没有公开的远端端点,所以不出配置。上面那条命令仅供参考,不是我们能担保的可复制命令——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 11 ★ · sunglasses-dev/sunglasses · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 11 ★ · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
sunglasses-dev/sunglasses;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# SUNGLASSES
以下摘录自该仓库的 README(片段)
Open source input firewall for AI agents, beta. A local scanner checks text, code, PDFs, images, QR codes, audio and video with 1,494 patterns that carry a matcher (1,565 are listed) across 117 listed categories and reports findings and incomplete scans. When the scanner cannot read part of an input, it says so and exits 3; an incomplete scan is never reported as clean. A Claude Code hook blocks secret material in tool calls and the paths and hosts your policy lists, before a tool runs, best effort under its 10 second timeout.
What works today
Scan text, files, PDFs, images and QR codes from the CLI or from Python
An MCP server your agent calls, and a GitHub Action that scans every pull request
A Claude Code hook that blocks the credential paths and policy violations your policy lists, before a tool runs
A local MCP proxy that refuses every tools/list and tools/call until a person
approves the server at an interactive terminal. Once approved, it withholds a
credential in a tool call or in a tool result, which is the credential lane and not
general inspection of everything a tool returns. Installing it is not protection
on its own. See What the proxy enforces.
Outside that lane this reads input, so a clean result is a confidence floor and not a guarantee
Sunglasses is a local, open source scanner for text and supported files. It reports what
it matched and what it could not read, so you can decide what to pass onward. It
produces findings and an exit status; a CI job, a Claude Code hook or your own code acts
on that result.
## Sixty seconds
bash
python3 -m venv .venv && source .venv/bin/activate
python -m pip install --upgrade sunglasses
curl -fsSL -o sixty-seconds.sh https://raw.githubusercontent.com/sunglasses-dev/sunglasses/main/demo/sixty-seconds.sh && bash sixty-seconds.sh
An activated virtualenv keeps the install and the sunglasses your shell resolves in the
same environment, and --upgrade matters if you already have an older version. curl -fsSL
fails on an HTTP error instead of saving the error page, so the script only runs if the
download actually succeeded.
The script writes three fixture files into a temp directory, and deliberately scans a fourth
path that does not exist, five scanner invocations in total, because the archive is scanned
twice (human output and JSON). The script's own commands execute; scanned content stays
data (it is never executed, and the ZIP is not extracted).
Abbreviated output, recorded on 0.5.6. Finding rows 2-5 are omitted below; timings and
presentation are not shown because they vary.
$ sunglasses scan --file notes.md # ordinary sprint notes
PASS — No threats detected.
scanner exit code: 0
$ sunglasses scan --file vendor-brief.md # a vendor brief with an instruction buried in it
BLOCK [HIGH] — 6 threat(s) found:
1. [HIGH] Ignore previous instructions GLS-PI-001
… findings 2-5 omitted …
6. [HIGH] Data exfiltration to sink (mechanism) GLS-MECH-003
scanner exit code: 1
$ sunglasses scan --file attachments.zip # an archive we do not extract
INCOMPLETE
No findings in the inspected scope. Part of this input was not read, so this is
not a clean result.
scanner exit code: 3
$ sunglasses scan --file missing.md
What works today
Scan text, files, PDFs, images and QR codes from the CLI or from Python
An MCP server your agent calls, and a GitHub Action that scans every pull request
A Claude Code hook that blocks the credential paths and policy violations your policy lists, before a tool runs
A local MCP proxy that refuses every tools/list and tools/call until a person
approves the server at an interactive terminal. Once approved, it withholds a
credential in a tool call or in a tool result, which is the credential lane and not
general inspection of everything a tool returns. Installing it is not protection
on its own. See What the proxy enforces.
Outside that lane this reads input, so a clean result is a confidence floor and not a guarantee
Sunglasses is a local, open source scanner for text and supported files. It reports what
it matched and what it could not read, so you can decide what to pass onward. It
produces findings and an exit status; a CI job, a Claude Code hook or your own code acts
on that result.
## Sixty seconds
bash
python3 -m venv .venv && source .venv/bin/activate
python -m pip install --upgrade sunglasses
curl -fsSL -o sixty-seconds.sh https://raw.githubusercontent.com/sunglasses-dev/sunglasses/main/demo/sixty-seconds.sh && bash sixty-seconds.sh
An activated virtualenv keeps the install and the sunglasses your shell resolves in the
same environment, and --upgrade matters if you already have an older version. curl -fsSL
fails on an HTTP error instead of saving the error page, so the script only runs if the
download actually succeeded.
The script writes three fixture files into a temp directory, and deliberately scans a fourth
path that does not exist, five scanner invocations in total, because the archive is scanned
twice (human output and JSON). The script's own commands execute; scanned content stays
data (it is never executed, and the ZIP is not extracted).
Abbreviated output, recorded on 0.5.6. Finding rows 2-5 are omitted below; timings and
presentation are not shown because they vary.
$ sunglasses scan --file notes.md # ordinary sprint notes
PASS — No threats detected.
scanner exit code: 0
$ sunglasses scan --file vendor-brief.md # a vendor brief with an instruction buried in it
BLOCK [HIGH] — 6 threat(s) found:
1. [HIGH] Ignore previous instructions GLS-PI-001
… findings 2-5 omitted …
6. [HIGH] Data exfiltration to sink (mechanism) GLS-MECH-003
scanner exit code: 1
$ sunglasses scan --file attachments.zip # an archive we do not extract
INCOMPLETE
No findings in the inspected scope. Part of this input was not read, so this is
not a clean result.
scanner exit code: 3
$ sunglasses scan --file missing.md
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/sunglasses-dev-sunglasses/)
- 来源
- awesome · https://github.com/sunglasses-dev/sunglasses
- 按领域浏览
- MCP 服务
- Traction
- 11 ★
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。