@rulecatch/mcp-server 1.0.0

package/dist/api-client.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP client for the Rulecatch MCP API.
+ * Reads config from ~/.claude/rulecatch/config.json.
+ */
+export declare class ApiClient {
+    private apiKey;
+    private baseUrl;
+    constructor();
+    request<T>(path: string, params?: Record<string, string>): Promise<T>;
+}

package/dist/api-client.js

@@ -0,0 +1,80 @@
+/**
+ * HTTP client for the Rulecatch MCP API.
+ * Reads config from ~/.claude/rulecatch/config.json.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_PATH = join(homedir(), '.claude', 'rulecatch', 'config.json');
+const MCP_ENDPOINTS = {
+    us: 'https://mcp.rulecatch.ai',
+    eu: 'https://mcp-eu.rulecatch.ai',
+};
+function loadConfig() {
+    if (!existsSync(CONFIG_PATH)) {
+        throw new Error('Rulecatch not configured. Run `npx @rulecatch/ai-pooler init` to set up.');
+    }
+    const raw = readFileSync(CONFIG_PATH, 'utf-8');
+    const config = JSON.parse(raw);
+    if (!config.apiKey) {
+        throw new Error('API key missing from config. Run `npx @rulecatch/ai-pooler init` to reconfigure.');
+    }
+    return config;
+}
+function getBaseUrl(config) {
+    // Priority: mcpEndpoint > derive from region
+    if (config.mcpEndpoint)
+        return config.mcpEndpoint;
+    return MCP_ENDPOINTS[config.region] || MCP_ENDPOINTS.us;
+}
+export class ApiClient {
+    apiKey;
+    baseUrl;
+    constructor() {
+        const config = loadConfig();
+        this.apiKey = config.apiKey;
+        this.baseUrl = getBaseUrl(config);
+    }
+    async request(path, params) {
+        const url = new URL(`/api/v1/mcp${path}`, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        let response;
+        try {
+            response = await fetch(url.toString(), {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    Accept: 'application/json',
+                },
+            });
+        }
+        catch (err) {
+            throw new Error('Cannot reach Rulecatch API. Check your internet connection.');
+        }
+        if (response.status === 401) {
+            throw new Error('Invalid API key. Run `npx @rulecatch/ai-pooler init` to configure.');
+        }
+        if (response.status === 403) {
+            const body = await response.json().catch(() => ({ error: '' }));
+            if (body.requiredPlans) {
+                throw new Error(`MCP tools require a Pro or Enterprise plan. Upgrade at dashboard.rulecatch.ai/billing.`);
+            }
+            throw new Error(body.error || 'Subscription inactive. Visit dashboard.rulecatch.ai/billing.');
+        }
+        if (response.status === 429) {
+            throw new Error('Rate limited. Try again in a moment.');
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`API error (${response.status}): ${body}`);
+        }
+        return (await response.json());
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Rulecatch MCP Server
+ *
+ * Runs on the customer's machine via stdio transport.
+ * Provides 5 tools for querying violations, rules, and generating fix plans.
+ *
+ * IMPORTANT: Never write to stdout (console.log) — it corrupts JSON-RPC messages.
+ * Use console.error() for logging.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * Rulecatch MCP Server
+ *
+ * Runs on the customer's machine via stdio transport.
+ * Provides 5 tools for querying violations, rules, and generating fix plans.
+ *
+ * IMPORTANT: Never write to stdout (console.log) — it corrupts JSON-RPC messages.
+ * Use console.error() for logging.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiClient } from './api-client.js';
+import { registerTools } from './tools.js';
+async function main() {
+    const server = new McpServer({
+        name: 'rulecatch',
+        version: '1.0.0',
+    });
+    let client;
+    try {
+        client = new ApiClient();
+    }
+    catch (err) {
+        console.error(`[Rulecatch MCP] Config error: ${err.message}`);
+        process.exit(1);
+    }
+    registerTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[Rulecatch MCP] Server running on stdio');
+}
+main().catch((error) => {
+    console.error('[Rulecatch MCP] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,MAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,iCAAkC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Rulecatch MCP tool definitions and handlers.
+ *
+ * 6 tools that map 1:1 to MCP API endpoints:
+ * - rulecatch_summary
+ * - rulecatch_violations
+ * - rulecatch_violation_detail
+ * - rulecatch_rules
+ * - rulecatch_fix_plan
+ * - rulecatch_top_rules
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ApiClient } from './api-client.js';
+export declare function registerTools(server: McpServer, client: ApiClient): void;

package/dist/tools.js

@@ -0,0 +1,394 @@
+/**
+ * Rulecatch MCP tool definitions and handlers.
+ *
+ * 6 tools that map 1:1 to MCP API endpoints:
+ * - rulecatch_summary
+ * - rulecatch_violations
+ * - rulecatch_violation_detail
+ * - rulecatch_rules
+ * - rulecatch_fix_plan
+ * - rulecatch_top_rules
+ */
+import { z } from 'zod';
+export function registerTools(server, client) {
+    // ── Summary ───────────────────────────────────────────────────────────────
+    server.registerTool('rulecatch_summary', {
+        description: 'Get a summary of Rulecatch violations and AI coding activity for a time period. Includes top violated rules and category breakdown.',
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe('Time period: today, 3d, 7d, 14d, 30d, this_week, this_month, all. Default: 7d'),
+        },
+    }, async ({ period }) => {
+        try {
+            const data = await client.request('/summary', {
+                period: period || '7d',
+            });
+            const v = data.violations;
+            const a = data.activity;
+            const lines = [
+                `Rulecatch Summary (${data.period})`,
+                '',
+                `Violations: ${v.total} total (${v.errors} errors, ${v.warnings} warnings, ${v.info} info)`,
+                `Corrected: ${v.corrected}/${v.total} (${v.correctionRate}%)`,
+                `Estimated Loss: $${v.estimatedLoss}`,
+                '',
+                `Sessions: ${a.sessions}`,
+                `Tool Calls: ${a.toolCalls}`,
+                `Cost: $${a.totalCost.toFixed(2)}`,
+                `Lines: +${a.linesAdded} / -${a.linesRemoved}`,
+            ];
+            if (data.topRules && data.topRules.length > 0) {
+                lines.push('', 'Top Violated Rules:');
+                for (const r of data.topRules) {
+                    lines.push(`  ${r.count}x ${r.ruleName} [${r.severity.toUpperCase()}]`);
+                }
+            }
+            if (data.byCategory && data.byCategory.length > 0) {
+                lines.push('', 'By Category:');
+                for (const c of data.byCategory) {
+                    lines.push(`  ${c.category}: ${c.count} (${c.errors} errors, ${c.warnings} warnings)`);
+                }
+            }
+            const text = lines.join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Violations list ───────────────────────────────────────────────────────
+    server.registerTool('rulecatch_violations', {
+        description: 'List Rulecatch rule violations. Filter by severity, category, session, corrected status, rule name, file path, language, tool, or branch.',
+        inputSchema: {
+            period: z.string().optional().describe('Time period (default: 7d)'),
+            severity: z
+                .string()
+                .optional()
+                .describe('Filter by severity: error, warning, info'),
+            category: z
+                .string()
+                .optional()
+                .describe('Filter by rule category: Security, Database Patterns, Coding Standards, Architecture, etc.'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Filter by AI session ID to see violations from a specific coding session'),
+            corrected: z
+                .string()
+                .optional()
+                .describe('Filter by corrected status: true or false'),
+            rule: z.string().optional().describe('Filter by rule name'),
+            file: z.string().optional().describe('Filter by file path'),
+            language: z.string().optional().describe('Filter by programming language'),
+            toolName: z.string().optional().describe('Filter by tool name (e.g. Write, Edit)'),
+            branch: z.string().optional().describe('Filter by git branch name'),
+            limit: z
+                .string()
+                .optional()
+                .describe('Max results (default: 20, max: 50)'),
+        },
+    }, async ({ period, severity, category, sessionId, corrected, rule, file, language, toolName, branch, limit }) => {
+        try {
+            const params = {};
+            if (period)
+                params.period = period;
+            if (severity)
+                params.severity = severity;
+            if (category)
+                params.category = category;
+            if (sessionId)
+                params.sessionId = sessionId;
+            if (corrected)
+                params.corrected = corrected;
+            if (rule)
+                params.rule = rule;
+            if (file)
+                params.file = file;
+            if (language)
+                params.language = language;
+            if (toolName)
+                params.toolName = toolName;
+            if (branch)
+                params.branch = branch;
+            if (limit)
+                params.limit = limit;
+            const data = await client.request('/violations', params);
+            if (data.violations.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No violations found for the given filters.',
+                        },
+                    ],
+                };
+            }
+            const lines = data.violations.map((v) => {
+                const status = v.corrected ? 'FIXED' : v.severity.toUpperCase();
+                return `[${status}] ${v.ruleName} — ${v.file}:${v.line} (${v.id})`;
+            });
+            const text = [
+                `${data.total} violations found (showing ${data.violations.length}):`,
+                '',
+                ...lines,
+            ].join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Violation detail ──────────────────────────────────────────────────────
+    server.registerTool('rulecatch_violation_detail', {
+        description: 'Get full details for a specific violation: file path, line number, rule description, matched conditions, git context. Use this before fixing a violation.',
+        inputSchema: {
+            id: z.string().describe('Violation ID (from rulecatch_violations or rulecatch_fix_plan)'),
+        },
+    }, async ({ id }) => {
+        try {
+            const v = await client.request(`/violations/${id}`);
+            const lines = [
+                `Rule: ${v.ruleName}`,
+                v.ruleDescription ? `Description: ${v.ruleDescription}` : '',
+                v.ruleCategory ? `Category: ${v.ruleCategory}` : '',
+                `Severity: ${v.severity}`,
+                v.fixTimeMinutes ? `Est. Fix Time: ${v.fixTimeMinutes} min` : '',
+                '',
+                `File: ${v.file}:${v.line}`,
+                v.language ? `Language: ${v.language}` : '',
+                v.toolName ? `Tool: ${v.toolName}` : '',
+                `Corrected: ${v.corrected}`,
+                '',
+            ];
+            if (v.fixGuide) {
+                lines.push('Fix Guide:');
+                lines.push(`  ${v.fixGuide}`);
+                lines.push('');
+            }
+            if (v.wrongExample) {
+                lines.push('Wrong:');
+                lines.push(v.wrongExample);
+                lines.push('');
+            }
+            if (v.correctExample) {
+                lines.push('Correct:');
+                lines.push(v.correctExample);
+                lines.push('');
+            }
+            if (v.matchedConditions && v.matchedConditions.length > 0) {
+                lines.push('Matched Conditions:');
+                for (const c of v.matchedConditions) {
+                    lines.push(`  - ${c.field} ${c.operator} "${c.value}"`);
+                }
+                lines.push('');
+            }
+            if (v.gitBranch || v.gitCommit || v.gitRepo) {
+                lines.push('Git Context:');
+                if (v.gitRepo)
+                    lines.push(`  Repo: ${v.gitRepo}`);
+                if (v.gitBranch)
+                    lines.push(`  Branch: ${v.gitBranch}`);
+                if (v.gitCommit)
+                    lines.push(`  Commit: ${v.gitCommit}`);
+            }
+            const text = lines.filter(Boolean).join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Rules list ────────────────────────────────────────────────────────────
+    server.registerTool('rulecatch_rules', {
+        description: 'List all active Rulecatch rules with their conditions, severity, and descriptions.',
+        inputSchema: {},
+    }, async () => {
+        try {
+            const data = await client.request('/rules');
+            if (data.rules.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No rules configured. Add rules in the Rulecatch dashboard.',
+                        },
+                    ],
+                };
+            }
+            const lines = data.rules.map((r) => {
+                const status = r.enabled ? r.severity.toUpperCase() : 'DISABLED';
+                let line = `[${status}] ${r.name}`;
+                if (r.description)
+                    line += ` — ${r.description}`;
+                if (r.conditions && r.conditions.length > 0) {
+                    const condStr = r.conditions
+                        .map((c) => `${c.field} ${c.operator} "${c.value}"`)
+                        .join(', ');
+                    line += `\n    Conditions: ${condStr}`;
+                }
+                return line;
+            });
+            const text = [`${data.rules.length} rules:`, '', ...lines].join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Fix plan ──────────────────────────────────────────────────────────────
+    server.registerTool('rulecatch_fix_plan', {
+        description: 'Get a file-by-file plan of uncorrected violations to fix. Groups by file with line numbers, rule descriptions, and conditions. Filter by session to fix violations from a specific coding session.',
+        inputSchema: {
+            period: z.string().optional().describe('Time period (default: 7d)'),
+            severity: z
+                .string()
+                .optional()
+                .describe('Filter severity: error, warning, info. Default: error + warning'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Filter by AI session ID to fix violations from a specific coding session'),
+            category: z
+                .string()
+                .optional()
+                .describe('Filter by rule category: Security, Database Patterns, etc.'),
+        },
+    }, async ({ period, severity, sessionId, category }) => {
+        try {
+            const params = {};
+            if (period)
+                params.period = period;
+            if (severity)
+                params.severity = severity;
+            if (sessionId)
+                params.sessionId = sessionId;
+            if (category)
+                params.category = category;
+            const data = await client.request('/fix-plan', params);
+            if (data.files.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No uncorrected violations found. Everything looks clean!',
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `Fix Plan: ${data.totalUncorrected} uncorrected violations across ${data.files.length} files`,
+                `Estimated fix time: ${data.estimatedFixTime} minutes (~$${data.estimatedCost} cost)`,
+                '',
+            ];
+            for (const f of data.files) {
+                lines.push(`--- ${f.file} (${f.violationCount} violations, worst: ${f.worstSeverity}) ---`);
+                for (const v of f.violations) {
+                    lines.push(`  Line ${v.line}: [${v.severity.toUpperCase()}] ${v.ruleName}`);
+                    if (v.ruleDescription) {
+                        lines.push(`    ${v.ruleDescription}`);
+                    }
+                    if (v.fixGuide) {
+                        lines.push(`    Fix: ${v.fixGuide}`);
+                    }
+                    if (v.wrongExample) {
+                        lines.push(`    Wrong: ${v.wrongExample}`);
+                    }
+                    if (v.correctExample) {
+                        lines.push(`    Correct: ${v.correctExample}`);
+                    }
+                    if (v.matchedConditions && v.matchedConditions.length > 0) {
+                        for (const c of v.matchedConditions) {
+                            lines.push(`    → ${c.field} ${c.operator} "${c.value}"`);
+                        }
+                    }
+                }
+                lines.push('');
+            }
+            const text = lines.join('\n');
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Top Rules ─────────────────────────────────────────────────────────────
+    server.registerTool('rulecatch_top_rules', {
+        description: 'Get the most frequently violated rules, ranked by count. Shows which rules are broken most often, with correction rates and category breakdown.',
+        inputSchema: {
+            period: z.string().optional().describe('Time period (default: 7d)'),
+            severity: z
+                .string()
+                .optional()
+                .describe('Filter by severity: error, warning, info'),
+            category: z
+                .string()
+                .optional()
+                .describe('Filter by rule category: Security, Database Patterns, etc.'),
+            limit: z
+                .string()
+                .optional()
+                .describe('Max rules to return (default: 10, max: 25)'),
+        },
+    }, async ({ period, severity, category, limit }) => {
+        try {
+            const params = {};
+            if (period)
+                params.period = period;
+            if (severity)
+                params.severity = severity;
+            if (category)
+                params.category = category;
+            if (limit)
+                params.limit = limit;
+            const data = await client.request('/top-rules', params);
+            if (data.rules.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No violations found for the given filters.',
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `Top Violated Rules (${data.period}) — ${data.totalViolations} total violations:`,
+                '',
+            ];
+            for (let i = 0; i < data.rules.length; i++) {
+                const r = data.rules[i];
+                lines.push(`${i + 1}. ${r.ruleName} — ${r.count} violations (${r.percentOfTotal}% of total)`);
+                lines.push(`   [${r.severity.toUpperCase()}] ${r.category} | Corrected: ${r.correctionRate}%`);
+                if (r.description) {
+                    lines.push(`   ${r.description}`);
+                }
+                lines.push('');
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Response types from the MCP API service.
+ */
+export interface SummaryTopRule {
+    ruleName: string;
+    count: number;
+    severity: string;
+}
+export interface SummaryCategoryBreakdown {
+    category: string;
+    count: number;
+    errors: number;
+    warnings: number;
+}
+export interface SummaryResponse {
+    violations: {
+        total: number;
+        corrected: number;
+        correctionRate: number;
+        errors: number;
+        warnings: number;
+        info: number;
+        estimatedLoss: number;
+    };
+    activity: {
+        sessions: number;
+        toolCalls: number;
+        totalCost: number;
+        linesAdded: number;
+        linesRemoved: number;
+    };
+    topRules: SummaryTopRule[];
+    byCategory: SummaryCategoryBreakdown[];
+    period: string;
+}
+export interface TopRuleItem {
+    ruleName: string;
+    count: number;
+    correctedCount: number;
+    correctionRate: number;
+    percentOfTotal: number;
+    severity: string;
+    category: string;
+    description?: string;
+    lastSeen: string;
+}
+export interface TopRulesResponse {
+    rules: TopRuleItem[];
+    totalViolations: number;
+    period: string;
+}
+export interface ViolationListItem {
+    id: string;
+    ruleName: string;
+    ruleDescription?: string;
+    severity: string;
+    file: string;
+    line: number;
+    toolName?: string;
+    gitBranch?: string;
+    corrected: boolean;
+    fixTimeMinutes?: number;
+    timestamp: string;
+}
+export interface ViolationsResponse {
+    violations: ViolationListItem[];
+    total: number;
+}
+export interface ViolationDetailResponse {
+    id: string;
+    ruleName: string;
+    ruleDescription?: string;
+    ruleCategory?: string;
+    ruleSource?: string;
+    severity: string;
+    fixTimeMinutes?: number;
+    file: string;
+    line: number;
+    language?: string;
+    toolName?: string;
+    matchedConditions?: Array<{
+        field: string;
+        operator: string;
+        value: string;
+    }>;
+    corrected: boolean;
+    gitUsername?: string;
+    gitEmail?: string;
+    gitRepo?: string;
+    gitBranch?: string;
+    gitCommit?: string;
+    fixGuide?: string;
+    wrongExample?: string;
+    correctExample?: string;
+    timestamp: string;
+    sessionId?: string;
+    eventId?: string;
+}
+export interface RuleItem {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    severity: string;
+    enabled: boolean;
+    fixTimeMinutes?: number;
+    conditions?: Array<{
+        field: string;
+        operator: string;
+        value: string;
+    }>;
+}
+export interface RulesResponse {
+    rules: RuleItem[];
+}
+export interface FixPlanFile {
+    file: string;
+    violationCount: number;
+    worstSeverity: string;
+    violations: Array<{
+        id: string;
+        ruleName: string;
+        ruleDescription?: string;
+        severity: string;
+        line: number;
+        fixTimeMinutes?: number;
+        matchedConditions?: Array<{
+            field: string;
+            operator: string;
+            value: string;
+        }>;
+        fixGuide?: string;
+        wrongExample?: string;
+        correctExample?: string;
+    }>;
+}
+export interface FixPlanResponse {
+    totalUncorrected: number;
+    estimatedFixTime: number;
+    estimatedCost: number;
+    files: FixPlanFile[];
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Response types from the MCP API service.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@rulecatch/mcp-server",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Rulecatch MCP server - query violations and rules from Claude Code",
+  "bin": {
+    "rulecatch-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "files": ["dist"],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.2.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "vitest": "^1.0.0"
+  }
+}