1 v0.1.1 更新于 2026-10-27
OPNsense Guard MCP Server
Safety-first OPNsense firewall MCP: read-only by default, planned and auto-reverting writes.
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(pypi)
{
"mcpServers": {
"opnsense-guard-mcp": {
"command": "uvx",
"args": [
"opnsense-guard-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 17 个工具
firewall_rules
查看防火墙规则列表
firewall_rule_get
获取单条防火墙规则详情
firewall_aliases
查看防火墙别名
interfaces
查看接口状态
service_list
查看服务列表
arp_table
查看 ARP 表
routing_table
查看路由表
firewall_states
查看防火墙状态表
firewall_log
查看防火墙实时日志
system_log
查看系统日志
system_information
查看系统信息
system_resources
查看系统资源使用情况
suricata_list
查看入侵检测(Suricata)相关列表
dhcp_leases
查看 DHCP 租约
system_status
查看固件/系统更新状态
rule_plan
规划防火墙规则变更,进行策略检查并返回差异但不实际修改
alias_plan
规划防火墙别名变更,进行策略检查并返回差异但不实际修改