coreyhines/opnsense-mcp

What it does

This is an MCP (Model Context Protocol) server that provides AI tools with direct API access to OPNsense firewall operations. It enables querying and managing critical firewall functions including ARP tables, DHCP configuration, firewall rules, system logs, network interfaces, system status, and packet capture data. By bridging OPNsense with AI assistants, it allows natural language queries and automation of complex firewall administration tasks.

How to set up

Clone the repository from GitHub and install Python dependencies. Configure the MCP server connection in your AI tool (Claude, ChatGPT, or compatible platform) by specifying STDIO or SSE transport. Provide your OPNsense API credentials and endpoint URL in the configuration. The server will then expose firewall operations as callable functions within your AI assistant's context.

Key features

• Query ARP tables and DHCP lease information
• Access and analyze firewall rules and configurations
• Review system logs and firewall activity
• Monitor network interfaces and system status
• Execute packet capture operations
• STDIO and SSE transport support for flexible deployment
• Python-based implementation for easy customization