透過 MCP 整合 AI 助手

Panguard 內建 MCP (Model Context Protocol) server，把安全工具暴露給 AI 助手。你可以透過 AI coding 助手用自然語言跑掃描、查 Guard 狀態、查威脅、部署蜜罐。

什麼是 MCP

MCP (Model Context Protocol) 是連接 AI 助手和外部工具的開放標準。Panguard 的 MCP server 把安全操作包裝成 AI 助手可以幫你呼叫的工具。支援的 AI 助手：

助手	Config 位置
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
Claude Code	`~/.claude/settings.local.json`
Cursor	`~/.cursor/mcp.json`
QClaw	`~/.qclaw/mcp.json`
OpenClaw	`~/.openclaw/skills/panguard/SKILL.md`（原生 Skill）
Codex	`~/.codex/mcp.json`
WorkBuddy	`~/.workbuddy/.mcp.json`
NemoClaw	`~/.nemoclaw/mcp.json`
ArkClaw	`~/.arkclaw/mcp.json`

跑 panguard setup 就能自動偵測並設定所有平台。不需登入。

加入 MCP config

把 Panguard MCP server 加到你 AI 助手的 config 檔：

Claude Desktop
Cursor
Windsurf

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "panguard": {
      "command": "panguard",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

在專案根目錄建立或編輯 .cursor/mcp.json：

{
  "mcpServers": {
    "panguard": {
      "command": "panguard",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

編輯 ~/.windsurf/mcp.json：

{
  "mcpServers": {
    "panguard": {
      "command": "panguard",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

存檔後重啟 AI 助手讓設定生效。

可用的 MCP 工具

Panguard MCP server 暴露這些工具給 AI 助手：

工具	說明
`scan_system`	跑安全掃描，回傳發現
`guard_status`	查 Guard 引擎狀態和近期事件
`guard_start`	啟動 Guard 引擎
`guard_stop`	停止 Guard 引擎
`get_threats`	查威脅情報和 IoC
`deploy_honeypot`	在指定服務/port 部署蜜罐
`get_attacker_profiles`	取得攻擊者分析報告
`generate_report`	產生合規報告
`get_security_score`	取得目前風險分數和等級
`list_events`	列出近期 Guard 事件，可篩選

用自然語言做安全操作

設好之後，你可以直接用自然語言跟 AI 助手互動：

跑安全掃描

你：「幫我掃描系統有沒有安全問題」助手會呼叫 scan_system，把發現、風險分數、建議整理成好讀的格式。

查防護狀態

你：「Guard 有在跑嗎？最近有什麼警報？」助手會呼叫 guard_status 和 list_events，給你完整的狀態概覽。

調查威脅

你：「查一下 IP 203.0.113.42 的資訊」助手會呼叫 get_threats 和 get_attacker_profiles，彙整威脅情資。

產生合規報告

你：「產生 ISO 27001 合規報告」助手會用 ISO 27001 框架呼叫 generate_report 並呈現結果。

部署蜜罐

你：「架 SSH 跟 HTTP 蜜罐來抓攻擊者」助手會為每種服務呼叫 deploy_honeypot，確認部署完成。

驗證連線

測試 AI 助手能不能連到 Panguard MCP server：

panguard mcp test

  PANGUARD AI - MCP Server

  -- Connection Test ------------------------

  Server:     Running (stdio transport)
  Tools:      10 registered
  Auth:       Authenticated (user@example.com)

  MCP server is ready for AI assistant connections.

下一步

MCP 產品參考

MCP server 架構和功能的完整文件。

MCP 工具參考

每個 MCP 工具的 schema，含參數和回傳型別。

第一次掃描

用 AI 輔助掃描之前，先了解掃描輸出。

即時防護

設好 Guard 讓 AI 助手能監控和回應威脅。

開始使用

核心概念

操作指南

設定

疑難排解

下一步

MCP 產品參考

MCP 工具參考

第一次掃描

即時防護

​下一步

MCP 產品參考

MCP 工具參考

第一次掃描

即時防護

下一步