@panguard-ai/panguard-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Panguard AI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Panguard MCP - CLI Entry Point
+ * Panguard MCP - CLI 入口點
+ *
+ * Starts the Panguard MCP server on stdio for integration with
+ * Claude Desktop, Cursor, or Claude Code.
+ * 在 stdio 上啟動 Panguard MCP 伺服器，用於與 Claude Desktop、Cursor 或 Claude Code 整合。
+ *
+ * @module @panguard-ai/panguard-mcp/cli
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/cli/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * Panguard MCP - CLI Entry Point
+ * Panguard MCP - CLI 入口點
+ *
+ * Starts the Panguard MCP server on stdio for integration with
+ * Claude Desktop, Cursor, or Claude Code.
+ * 在 stdio 上啟動 Panguard MCP 伺服器，用於與 Claude Desktop、Cursor 或 Claude Code 整合。
+ *
+ * @module @panguard-ai/panguard-mcp/cli
+ */
+import { startMCPServer, PANGUARD_MCP_VERSION } from '../server.js';
+import { createLogger } from '@panguard-ai/core';
+const logger = createLogger('panguard-mcp:cli');
+// Print version if --version or -v flag provided
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    process.stdout.write(PANGUARD_MCP_VERSION + '\n');
+    process.exit(0);
+}
+// Print help if --help or -h flag provided
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    process.stdout.write(`
+Panguard MCP Server v${PANGUARD_MCP_VERSION}
+Usage: panguard-mcp [options]
+
+Options:
+  --version, -v    Print version and exit
+  --help, -h       Print this help and exit
+
+Description:
+  Starts the Panguard MCP server on stdio, allowing Claude Desktop,
+  Cursor, or Claude Code to control Panguard security scanning and
+  real-time threat monitoring via conversation.
+
+  透過 stdio 啟動 Panguard MCP 伺服器，讓 Claude Desktop、Cursor
+  或 Claude Code 透過對話控制 Panguard 安全掃描和即時威脅監控。
+
+Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
+  {
+    "mcpServers": {
+      "panguard": {
+        "command": "panguard-mcp"
+      }
+    }
+  }
+
+Available tools:
+  panguard_scan           Run system security health check
+  panguard_scan_code      Scan source code for vulnerabilities (SAST)
+  panguard_guard_start    Start real-time threat monitoring
+  panguard_guard_stop     Stop threat monitoring daemon
+  panguard_status         Get status of all Panguard services
+  panguard_alerts         Get recent security alerts
+  panguard_block_ip       Manually block an IP address
+  panguard_generate_report Generate PDF compliance report
+  panguard_init           Initialize Panguard configuration
+  panguard_deploy         One-click deployment of all Panguard services
+`);
+    process.exit(0);
+}
+// Start the MCP server
+startMCPServer().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    logger.error('MCP server failed to start: ' + message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAEhD,iDAAiD;AACjD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,2CAA2C;AAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;uBACA,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC1C,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,uBAAuB;AACvB,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,OAAO,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Panguard MCP - Public API
+ * Panguard MCP - 公開 API
+ *
+ * MCP server for Panguard AI — control security scanning and guard from
+ * Claude Desktop, Cursor, or Claude Code via conversation.
+ * 用於 Panguard AI 的 MCP 伺服器 — 透過對話從 Claude Desktop、Cursor 或 Claude Code 控制安全掃描和守護。
+ *
+ * @module @panguard-ai/panguard-mcp
+ */
+export { startMCPServer, getAllToolDefinitions, dispatchTool, PANGUARD_MCP_VERSION } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Panguard MCP - Public API
+ * Panguard MCP - 公開 API
+ *
+ * MCP server for Panguard AI — control security scanning and guard from
+ * Claude Desktop, Cursor, or Claude Code via conversation.
+ * 用於 Panguard AI 的 MCP 伺服器 — 透過對話從 Claude Desktop、Cursor 或 Claude Code 控制安全掃描和守護。
+ *
+ * @module @panguard-ai/panguard-mcp
+ */
+export { startMCPServer, getAllToolDefinitions, dispatchTool, PANGUARD_MCP_VERSION } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,356 @@
+/**
+ * Panguard MCP - Server
+ * Panguard MCP - 伺服器
+ *
+ * Main MCP server entry: registers all tools and dispatches incoming requests.
+ * 主要 MCP 伺服器入口：註冊所有工具並分派傳入請求。
+ *
+ * @module @panguard-ai/panguard-mcp/server
+ */
+/** MCP server version / MCP 伺服器版本 */
+export declare const PANGUARD_MCP_VERSION: string;
+/**
+ * Returns the complete list of all MCP tool definitions.
+ * 返回所有 MCP 工具定義的完整清單。
+ */
+export declare function getAllToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            depth: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            lang: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            dir?: undefined;
+            dataDir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dir: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            lang: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            depth?: undefined;
+            dataDir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dataDir: {
+                type: string;
+                description: string;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+                default?: undefined;
+            };
+            depth?: undefined;
+            lang?: undefined;
+            dir?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dataDir: {
+                type: string;
+                description: string;
+            };
+            depth?: undefined;
+            lang?: undefined;
+            dir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            severity: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            dataDir: {
+                type: string;
+                description: string;
+            };
+            depth?: undefined;
+            lang?: undefined;
+            dir?: undefined;
+            mode?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            ip: {
+                type: string;
+                description: string;
+            };
+            duration: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            depth?: undefined;
+            lang?: undefined;
+            dir?: undefined;
+            dataDir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            output: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            lang: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            depth: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            dir?: undefined;
+            dataDir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dataDir: {
+                type: string;
+                description: string;
+            };
+            lang: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            depth?: undefined;
+            dir?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+            generateReport?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            depth?: undefined;
+            lang?: undefined;
+            dir?: undefined;
+            dataDir?: undefined;
+            mode?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            generateReport?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            dataDir: {
+                type: string;
+                description: string;
+            };
+            lang: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                default: string;
+                description?: undefined;
+            };
+            generateReport: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            depth?: undefined;
+            dir?: undefined;
+            limit?: undefined;
+            severity?: undefined;
+            ip?: undefined;
+            duration?: undefined;
+            reason?: undefined;
+            output?: undefined;
+            path?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+/**
+ * Dispatch an incoming tool call to the appropriate handler.
+ * 將傳入的工具呼叫分派給適當的處理程序。
+ *
+ * @param name - Tool name / 工具名稱
+ * @param args - Tool arguments / 工具參數
+ */
+export declare function dispatchTool(name: string, args: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+/**
+ * Create and start the MCP server using stdio transport.
+ * 使用 stdio 傳輸建立並啟動 MCP 伺服器。
+ *
+ * This is the main entry point for the MCP server process.
+ * 這是 MCP 伺服器進程的主要入口點。
+ */
+export declare function startMCPServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,EAAE,MAAqB,CAAC;AAmPzD;;;GAGG;AACH,wBAAgB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEpC;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAoC7E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBpD"}