Beennnn/hass-scs-sentinel
GitHub: Beennnn/hass-scs-sentinel
将 SCS Sentinel 自动门套件通过逆向工程桥接至 Home Assistant 和 Claude MCP 的开源项目。
Stars: 0 | Forks: 0
# hass-scs-sentinel
**SCS Sentinel** 自动门套件（iSCS Sentinel 移动应用、WifiGate AAM0125 Wi-Fi 模块、scs-sentinel.com）与以下平台之间的开源桥接：
1. **Home Assistant** — 可通过 [HACS](https://hacs.xyz/) 安装的自定义集成 — 将大门暴露为 `cover` 实体。
2. **Claude（或任何 MCP 客户端）** — 带有 `gate_open` / `gate_close` / `gate_stop` / `gate_status` / `gate_list` 工具的 stdio MCP 服务器。
两者都使用了一个共享的异步 Python 协议库（`scs-sentinel`），该库是通过逆向工程官方 iSCS Sentinel 应用程序得出的。
## 为什么开发此项目
官方的 iSCS Sentinel 应用程序是目前唯一可以通过手机控制大门的方式。目前没有可用的 Home Assistant 集成，也没有公开的协议文档。本项目填补了这一空白，以便该套件的所有者可以：
- 通过现有的 Home Assistant 设置控制大门（与灯光、摄像头、存在检测联动）。
- 通过语音让 Claude 打开大门（`mcp_server` 将大门暴露为 MCP 工具）。
- 应对厂商云服务的更改——该协议已在 [docs/reverse-engineering/03-protocol.md](docs/reverse-engineering/03-protocol.md) 中记录（编写中）。
## 安装
### 通过 HACS 安装 Home Assistant 集成 — *将在 v0.1.0 之后推出*
```
HACS → Integrations → ⋮ → Custom repositories → URL: https://github.com/Beennnn/hass-scs-sentinel → Type: Integration
```
然后转到 `Settings → Devices & Services → Add Integration → SCS Sentinel`，填入你的 iSCS Sentinel 电子邮件和密码。
### Claude 的 MCP 服务器 — *将在 v0.1.0 之后推出*
```
{
"mcpServers": {
"scs-sentinel": {
"command": "uvx",
"args": ["scs-sentinel-mcp"],
"env": {
"SCS_EMAIL": "you@example.com",
"SCS_PASSWORD": "..."
}
}
}
}
```
将其放入 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) 或你所用平台上的对应路径。
## 仓库结构
```
custom_components/scs_sentinel/ # Home Assistant integration (HACS-installable)
src/scs_sentinel/ # Async Python protocol library (httpx + pydantic v2)
mcp_server/ # Stdio MCP server consuming the lib
docs/reverse-engineering/ # Protocol RE artefacts + spec
docs/adr/ # Architecture Decision Records
docs/legal/ # EU interoperability framing
bin/re/ # Local RE helpers (apk pull, jadx, mitmproxy)
bin/dev/ # Local dev helpers (HA container, MCP server)
```
## 免责声明
- **非官方项目**。不隶属于、未受认可、也不受 SCS Sentinel SA 支持。
- **个人互操作性**。逆向工程是在项目作者自有的套件上进行的，其唯一目的是与作者自己的大门实现互操作，这符合 [EU Directive 2009/24/EC article 6](https://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2009:111:0016:0022:EN:PDF) 的规定。参见 [docs/legal/eu-interop-doctrine.md](docs/legal/eu-interop-doctrine.md)。
- **无担保**。此集成控制的是一个可以夹伤、撞击或困住人的物理设备。请始终保持官方套件的安全防撞和光幕保护功能处于激活状态。使用风险自负。
- **云服务依赖**。该协议与 SCS Sentinel 的云服务器进行通信。如果供应商更改其 API 或关闭云服务，此集成在更新之前将失效。
## 许可证
[MIT](LICENSE) — © 2026 Benoit Besson.
标签：Claude, custom integration, CVE检测, DNS解析, HACS, Home Assistant, IoT桥接, MCP, MCP Server, Python, SCS Sentinel, Wi-Fi模块, 云资产清单, 协议分析, 开源项目, 异步编程, 插件系统, 文档安全, 无后门, 智能家居, 智能硬件, 智能设备集成, 权限提升, 物联网, 物联网安全, 自动化门禁, 计算机取证, 语音控制, 运行时操纵, 逆向工具, 逆向工程