OPNsense MCP Server

Name: OPNsense MCP Server
Author: Richard Stovall

Richard Stovall

开始使用源码仓库

Modular MCP server for OPNsense firewall management - 88 tools providing access to 2000+ methods through AI assistants

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add opnsense --env OPNSENSE_URL='<OPNSENSE_URL>' --env OPNSENSE_API_KEY='<OPNSENSE_API_KEY>' --env OPNSENSE_API_SECRET='<OPNSENSE_API_SECRET>' -- npx -y @richard-stovall/opnsense-mcp-server

~/.codex/config.toml

[mcp_servers.opnsense]
command = "npx"
args = ["-y", "@richard-stovall/opnsense-mcp-server"]
env = { OPNSENSE_URL = "<OPNSENSE_URL>", OPNSENSE_API_KEY = "<OPNSENSE_API_KEY>", OPNSENSE_API_SECRET = "<OPNSENSE_API_SECRET>" }

# codex mcp add opnsense --env OPNSENSE_URL='<OPNSENSE_URL>' --env OPNSENSE_API_KEY='<OPNSENSE_API_KEY>' --env OPNSENSE_API_SECRET='<OPNSENSE_API_SECRET>' -- npx -y @richard-stovall/opnsense-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "opnsense": {
      "command": "npx",
      "args": [
        "-y",
        "@richard-stovall/opnsense-mcp-server"
      ],
      "env": {
        "OPNSENSE_URL": "<OPNSENSE_URL>",
        "OPNSENSE_API_KEY": "<OPNSENSE_API_KEY>",
        "OPNSENSE_API_SECRET": "<OPNSENSE_API_SECRET>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "opnsense": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@richard-stovall/opnsense-mcp-server"
      ],
      "env": {
        "OPNSENSE_URL": "<OPNSENSE_URL>",
        "OPNSENSE_API_KEY": "<OPNSENSE_API_KEY>",
        "OPNSENSE_API_SECRET": "<OPNSENSE_API_SECRET>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "opnsense": {
      "command": "npx",
      "args": [
        "-y",
        "@richard-stovall/opnsense-mcp-server"
      ],
      "env": {
        "OPNSENSE_URL": "<OPNSENSE_URL>",
        "OPNSENSE_API_KEY": "<OPNSENSE_API_KEY>",
        "OPNSENSE_API_SECRET": "<OPNSENSE_API_SECRET>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "opnsense": {
      "command": "npx",
      "args": [
        "-y",
        "@richard-stovall/opnsense-mcp-server"
      ],
      "env": {
        "OPNSENSE_URL": "<OPNSENSE_URL>",
        "OPNSENSE_API_KEY": "<OPNSENSE_API_KEY>",
        "OPNSENSE_API_SECRET": "<OPNSENSE_API_SECRET>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "opnsense": {
      "command": "npx",
      "args": [
        "-y",
        "@richard-stovall/opnsense-mcp-server"
      ],
      "env": {
        "OPNSENSE_URL": "<OPNSENSE_URL>",
        "OPNSENSE_API_KEY": "<OPNSENSE_API_KEY>",
        "OPNSENSE_API_SECRET": "<OPNSENSE_API_SECRET>"
      }
    }
  }
}

需要的环境变量

OPNSENSE_URL
OPNSENSE_API_KEY
OPNSENSE_API_SECRET

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐