@guardrail-ai/mcp 0.1.0

package/README.md

@@ -0,0 +1,29 @@
+# @guardrail-ai/mcp
+
+Model Context Protocol (MCP) server for Guardrail. Use Guardrail as a Claude Code plugin or with any MCP-compatible AI assistant.
+
+## Setup with Claude Code
+
+Add to your Claude Code settings (`.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "guardrail": {
+      "command": "npx",
+      "args": ["@guardrail-ai/mcp"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### guardrail_scan
+Scan a directory or file for issues.
+
+### guardrail_fix
+Auto-fix detected issues (dry-run by default).
+
+### guardrail_list_rules
+List all 19 built-in detection rules.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const core_1 = require("@guardrail-ai/core");
+const rules_1 = require("@guardrail-ai/rules");
+const fixer_1 = require("@guardrail-ai/fixer");
+const server = new mcp_js_1.McpServer({
+    name: 'guardrail',
+    version: '0.1.0',
+});
+// ── Tool: scan ──────────────────────────────────────────────────────────────
+server.tool('guardrail_scan', 'Scan a directory or file for security issues, performance problems, bad patterns, and AI-generated code anti-patterns. Returns structured violations with file, line, severity, and rule ID.', {
+    target: zod_1.z.string().describe('Path to a file or directory to scan'),
+    severity: zod_1.z
+        .enum(['critical', 'high', 'warning', 'info'])
+        .optional()
+        .describe('Minimum severity threshold (default: info)'),
+}, async ({ target, severity }) => {
+    const engine = new core_1.GuardrailEngine({
+        severityThreshold: severity ?? 'info',
+    });
+    engine.registerRules(rules_1.builtinRules);
+    const summary = await engine.scan(target);
+    const lines = [];
+    lines.push(`Scanned ${summary.totalFiles} files. Found ${summary.totalViolations} issues.`);
+    lines.push(`  Critical: ${summary.bySeverity.critical}, High: ${summary.bySeverity.high}, Warning: ${summary.bySeverity.warning}, Info: ${summary.bySeverity.info}`);
+    lines.push('');
+    for (const result of summary.results) {
+        if (result.violations.length === 0)
+            continue;
+        lines.push(`${result.filePath}:`);
+        for (const v of result.violations) {
+            const fix = v.fix ? ' (fixable)' : '';
+            lines.push(`  ${v.severity.toUpperCase()} ${v.location.line}:${v.location.column} ${v.message} [${v.ruleId}]${fix}`);
+        }
+        lines.push('');
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+});
+// ── Tool: fix ───────────────────────────────────────────────────────────────
+server.tool('guardrail_fix', 'Auto-fix detected issues in a directory or file using AST transformations. Returns diffs of applied changes.', {
+    target: zod_1.z.string().describe('Path to a file or directory to fix'),
+    dryRun: zod_1.z
+        .boolean()
+        .optional()
+        .describe('If true, show diffs without applying changes (default: true)'),
+}, async ({ target, dryRun = true }) => {
+    const engine = new core_1.GuardrailEngine();
+    engine.registerRules(rules_1.builtinRules);
+    const summary = await engine.scan(target);
+    const fixer = new fixer_1.FixerEngine();
+    const lines = [];
+    let totalFixed = 0;
+    for (const result of summary.results) {
+        const fixable = result.violations.filter((v) => v.fix);
+        if (fixable.length === 0)
+            continue;
+        const fixResult = await fixer.applyFixes(result.filePath, result.violations, !dryRun);
+        if (fixResult.applied > 0) {
+            totalFixed += fixResult.applied;
+            if (fixResult.diff) {
+                lines.push(fixResult.diff);
+            }
+        }
+    }
+    if (totalFixed === 0) {
+        lines.push('No auto-fixable issues found.');
+    }
+    else {
+        const action = dryRun ? 'would fix' : 'fixed';
+        lines.push(`\n${totalFixed} issues ${action}.`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+});
+// ── Tool: list-rules ────────────────────────────────────────────────────────
+server.tool('guardrail_list_rules', 'List all available Guardrail detection rules with their IDs, categories, and severities.', {}, async () => {
+    const lines = rules_1.builtinRules.map((r) => `${r.id} | ${r.category} | ${r.severity} | ${r.description}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `ID | Category | Severity | Description\n${'-'.repeat(80)}\n${lines.join('\n')}`,
+            },
+        ],
+    };
+});
+// ── Start ───────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@guardrail-ai/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server for Guardrail — use as a Claude Code plugin",
+  "main": "dist/index.js",
+  "bin": {
+    "guardrail-mcp": "dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Manavarya09/Guardrail.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/Manavarya09/Guardrail",
+  "bugs": "https://github.com/Manavarya09/Guardrail/issues",
+  "keywords": ["guardrail", "mcp", "claude", "claude-code", "model-context-protocol"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@guardrail-ai/core": "*",
+    "@guardrail-ai/rules": "*",
+    "@guardrail-ai/fixer": "*",
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "license": "MIT"
+}