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

よくある質問

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.

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.

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.

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.

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.

「その他」の他のコンテンツ

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

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