广告合作
MCP.so
登录
O

Opnsense MCP Server

@coreyhines

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

coreyhines

提交者

Corey Hines

关于 Opnsense MCP Server

The OPNsense MCP Server provides comprehensive network management capabilities through the Model Context Protocol (MCP), enabling natural language interaction with your OPNsense firewall. Manage devices, monitor traffic, configure firewall rules, and troubleshoot network issues u

#opnsense#network-management#ai-assistant

Opnsense MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "opnsense-mcp": {
      "name": "OPNsense MCP",
      "version": "1.0.0",
      "command": "/bin/bash",
      "args": [
        "/path/to//opnsense-mcp/mcp_start.sh"
      ],
      "cwd": "/path/to//opnsense-mcp",
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONIOENCODING": "utf-8",
        "DEBUG": "1"
      },
      "transport": {
        "type": "stdio",
        "encoding": "utf-8"
      }
    }
  }
}

Opnsense MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Opnsense Mcp?

The OPNsense MCP Server provides comprehensive network management capabilities through the Model Context Protocol (MCP), enabling natural language interaction with your OPNsense firewall. It is designed for managing devices, monitoring traffic, configuring firewall rules, and troubleshooting network issues using AI chat interfaces.

How to use Opnsense Mcp?

Install dependencies (uv, virtual environment, requirements.txt), copy and configure the example environment file (~/.opnsense-env) with your API key, secret, firewall host, and JWT secret key, then start the server with uv run python main.py. Integrate with tools like Cursor IDE, LM Studio, or Continue by adding a JSON-RPC over stdio MCP server configuration pointing to the provided mcp_start.sh script.

Key features of Opnsense Mcp

  • Network discovery via ARP, DHCP, and LLDP tables
  • System monitoring for CPU, memory, disk, and health
  • Firewall rule creation, inspection, and deletion
  • Live packet capture and traffic analysis
  • JWT-based authentication and environment-based secrets

Use cases of Opnsense Mcp

  • Find and identify all devices on the network
  • Perform security analysis for suspicious traffic
  • Troubleshoot why a device cannot connect to a service
  • Create or block firewall rules with natural language

常见问题

1

What authentication method does the server use?

The server uses JWT-based authentication for internal operations and stores all credentials in the `~/.opnsense-env` environment file. No secrets are hardcoded.

2

What runtime and dependencies are required?

The server requires Python, uv (fast package installer), and the packages listed in `requirements.txt`. It communicates via JSON-RPC over stdio, not HTTP endpoints.

3

How do I resolve authentication failures?

Verify your `~/.opnsense-env` file contains the correct API key, API secret, firewall host, and MCP secret key. Ensure the file is properly sourced before starting the server.

4

Where can I find detailed API documentation?

Refer to the [Function Reference](docs/REFERENCE/FUNCTION_REFERENCE.md) for a complete list of all supported functions and parameters.

5

What are common troubleshooting steps for import or port conflicts?

Ensure all dependencies are installed with `uv pip install -r requirements.txt`. For port conflicts, change the port in your configuration or launch arguments.

评论

其他 分类下的更多 MCP 服务器

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

ICSS

chokcoco

不止于 CSS

20.7K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
广告合作