mcp-lint 0.1.0

package/dist/rules/index.js

@@ -0,0 +1,28 @@
+import { noRequiredFalse } from './no-required-false.js';
+import { noContentEncoding } from './no-content-encoding.js';
+import { descriptionExists } from './description-exists.js';
+import { noEmptyEnum } from './no-empty-enum.js';
+import { maxDepth } from './max-depth.js';
+import { noRecursiveRefs } from './no-recursive-refs.js';
+import { validJsonSchemaSubset } from './valid-json-schema-subset.js';
+import { noUnsupportedFormats } from './no-unsupported-formats.js';
+import { claudeNoTypeArray } from './client-specific/claude.js';
+import { cursorNoDefaultWithoutType } from './client-specific/cursor.js';
+import { geminiNoOptionalWithoutDefault, geminiNoNestedObjects } from './client-specific/gemini.js';
+import { vscodeMaxParams } from './client-specific/vscode.js';
+export const allRules = [
+    noRequiredFalse,
+    noContentEncoding,
+    descriptionExists,
+    noEmptyEnum,
+    maxDepth,
+    noRecursiveRefs,
+    validJsonSchemaSubset,
+    noUnsupportedFormats,
+    claudeNoTypeArray,
+    cursorNoDefaultWithoutType,
+    geminiNoOptionalWithoutDefault,
+    geminiNoNestedObjects,
+    vscodeMaxParams,
+];
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,CAAC,MAAM,QAAQ,GAAW;IAC9B,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB;IACjB,0BAA0B;IAC1B,8BAA8B;IAC9B,qBAAqB;IACrB,eAAe;CAChB,CAAC"}

package/dist/rules/max-depth.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const maxDepth: Rule;

package/dist/rules/max-depth.js

@@ -0,0 +1,59 @@
+function getMaxDepth(schema, depth = 0) {
+    if (!schema || typeof schema !== 'object')
+        return depth;
+    let max = depth;
+    if (schema.properties) {
+        for (const value of Object.values(schema.properties)) {
+            max = Math.max(max, getMaxDepth(value, depth + 1));
+        }
+    }
+    if (schema.items) {
+        if (Array.isArray(schema.items)) {
+            for (const item of schema.items) {
+                max = Math.max(max, getMaxDepth(item, depth + 1));
+            }
+        }
+        else {
+            max = Math.max(max, getMaxDepth(schema.items, depth + 1));
+        }
+    }
+    for (const kw of ['anyOf', 'oneOf', 'allOf']) {
+        const arr = schema[kw];
+        if (Array.isArray(arr)) {
+            for (const s of arr) {
+                max = Math.max(max, getMaxDepth(s, depth + 1));
+            }
+        }
+    }
+    if (schema.not)
+        max = Math.max(max, getMaxDepth(schema.not, depth + 1));
+    if (schema.if)
+        max = Math.max(max, getMaxDepth(schema.if, depth + 1));
+    if (schema.then)
+        max = Math.max(max, getMaxDepth(schema.then, depth + 1));
+    if (schema.else)
+        max = Math.max(max, getMaxDepth(schema.else, depth + 1));
+    return max;
+}
+export const maxDepth = {
+    id: 'max-depth',
+    severity: 'warning',
+    description: 'Deeply nested schemas confuse LLMs and increase token consumption.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, context) {
+        const limit = context.config.maxDepth ?? 5;
+        const depth = getMaxDepth(tool.inputSchema);
+        if (depth > limit) {
+            return [{
+                    ruleId: 'max-depth',
+                    severity: 'warning',
+                    message: `Tool "${tool.name}" schema has nesting depth of ${depth}, which exceeds the limit of ${limit}. Keep schemas flat for better LLM comprehension.`,
+                    toolName: tool.name,
+                    path: 'inputSchema',
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                }];
+        }
+        return [];
+    },
+};
+//# sourceMappingURL=max-depth.js.map

package/dist/rules/max-depth.js.map

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

package/dist/rules/no-content-encoding.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const noContentEncoding: Rule;

package/dist/rules/no-content-encoding.js

@@ -0,0 +1,33 @@
+import { walkSchema } from '../utils/schema-walker.js';
+export const noContentEncoding = {
+    id: 'no-content-encoding',
+    severity: 'error',
+    description: '`contentEncoding` is not part of the JSON Schema subset used by MCP clients.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if ('contentEncoding' in schema) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'no-content-encoding',
+                    severity: 'error',
+                    message: `"contentEncoding" at "${diagnosticPath}" is not supported by MCP clients and causes parse failures in strict validators.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    fix: {
+                        description: 'Remove `contentEncoding` field',
+                        apply: (s) => {
+                            const copy = { ...s };
+                            delete copy['contentEncoding'];
+                            return copy;
+                        },
+                    },
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=no-content-encoding.js.map

package/dist/rules/no-content-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-content-encoding.js","sourceRoot":"","sources":["../../src/rules/no-content-encoding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,EAAE,EAAE,qBAAqB;IACzB,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,8EAA8E;IAC3F,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAAC;gBAChC,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,qBAAqB;oBAC7B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,yBAAyB,cAAc,mFAAmF;oBACnI,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;oBACjD,GAAG,EAAE;wBACH,WAAW,EAAE,gCAAgC;wBAC7C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;4BACX,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;4BACtB,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC;4BAC/B,OAAO,IAAI,CAAC;wBACd,CAAC;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/no-empty-enum.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const noEmptyEnum: Rule;

package/dist/rules/no-empty-enum.js

@@ -0,0 +1,33 @@
+import { walkSchema } from '../utils/schema-walker.js';
+export const noEmptyEnum = {
+    id: 'no-empty-enum',
+    severity: 'error',
+    description: 'An empty `enum` array makes the parameter impossible to satisfy.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (Array.isArray(schema.enum) && schema.enum.length === 0) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'no-empty-enum',
+                    severity: 'error',
+                    message: `Empty \`enum: []\` at "${diagnosticPath}" makes the parameter impossible to satisfy. This is likely a bug.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    fix: {
+                        description: 'Remove the `enum` field',
+                        apply: (s) => {
+                            const copy = { ...s };
+                            delete copy['enum'];
+                            return copy;
+                        },
+                    },
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=no-empty-enum.js.map

package/dist/rules/no-empty-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-empty-enum.js","sourceRoot":"","sources":["../../src/rules/no-empty-enum.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,eAAe;IACnB,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,kEAAkE;IAC/E,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,eAAe;oBACvB,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,0BAA0B,cAAc,oEAAoE;oBACrH,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;oBACjD,GAAG,EAAE;wBACH,WAAW,EAAE,yBAAyB;wBACtC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;4BACX,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;4BACtB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;4BACpB,OAAO,IAAI,CAAC;wBACd,CAAC;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/no-recursive-refs.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const noRecursiveRefs: Rule;

package/dist/rules/no-recursive-refs.js

@@ -0,0 +1,68 @@
+function detectCycle(schema, allDefs, chain) {
+    if (!schema || typeof schema !== 'object')
+        return false;
+    if (typeof schema.$ref === 'string') {
+        const match = schema.$ref.match(/^#\/(?:\$defs|definitions)\/(.+)$/);
+        if (match) {
+            const defName = match[1];
+            if (chain.has(defName))
+                return true;
+            const def = allDefs[defName];
+            if (def) {
+                return detectCycle(def, allDefs, new Set([...chain, defName]));
+            }
+        }
+        return false;
+    }
+    const subs = [
+        ...(schema.properties ? Object.values(schema.properties) : []),
+        ...(Array.isArray(schema.items) ? schema.items : schema.items ? [schema.items] : []),
+        ...(schema.anyOf ?? []),
+        ...(schema.oneOf ?? []),
+        ...(schema.allOf ?? []),
+        schema.not,
+        schema.if,
+        schema.then,
+        schema.else,
+    ];
+    return subs.filter((s) => s != null).some((s) => detectCycle(s, allDefs, chain));
+}
+export const noRecursiveRefs = {
+    id: 'no-recursive-refs',
+    severity: 'error',
+    description: 'Circular $ref causes infinite loops or crashes in most MCP clients.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const schema = tool.inputSchema;
+        const allDefs = {
+            ...(schema.$defs ?? {}),
+            ...(schema.definitions ?? {}),
+        };
+        // Check from root
+        if (detectCycle(schema, allDefs, new Set())) {
+            return [{
+                    ruleId: 'no-recursive-refs',
+                    severity: 'error',
+                    message: `Tool "${tool.name}" schema contains a circular $ref that could cause infinite loops or crashes in MCP clients.`,
+                    toolName: tool.name,
+                    path: 'inputSchema',
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                }];
+        }
+        // Check definitions not reachable from root
+        for (const [defName, def] of Object.entries(allDefs)) {
+            if (detectCycle(def, allDefs, new Set([defName]))) {
+                return [{
+                        ruleId: 'no-recursive-refs',
+                        severity: 'error',
+                        message: `Definition "$defs.${defName}" in tool "${tool.name}" contains a circular $ref.`,
+                        toolName: tool.name,
+                        path: `inputSchema.$defs.${defName}`,
+                        clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    }];
+            }
+        }
+        return [];
+    },
+};
+//# sourceMappingURL=no-recursive-refs.js.map

package/dist/rules/no-recursive-refs.js.map

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

package/dist/rules/no-required-false.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const noRequiredFalse: Rule;

package/dist/rules/no-required-false.js

@@ -0,0 +1,33 @@
+import { walkSchema } from '../utils/schema-walker.js';
+export const noRequiredFalse = {
+    id: 'no-required-false',
+    severity: 'error',
+    description: '`required: false` on a property is not valid JSON Schema. Properties are optional by default.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (schema.required === false) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'no-required-false',
+                    severity: 'error',
+                    message: `Schema node at "${diagnosticPath}" has \`required: false\` which is not valid JSON Schema. Remove it — properties are optional by default unless listed in the parent's \`required\` array.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    fix: {
+                        description: 'Remove `required: false` from the property',
+                        apply: (s) => {
+                            const copy = { ...s };
+                            delete copy['required'];
+                            return copy;
+                        },
+                    },
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=no-required-false.js.map

package/dist/rules/no-required-false.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-required-false.js","sourceRoot":"","sources":["../../src/rules/no-required-false.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,EAAE,EAAE,mBAAmB;IACvB,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,+FAA+F;IAC5G,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAK,MAAkC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,mBAAmB;oBAC3B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,mBAAmB,cAAc,4JAA4J;oBACtM,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;oBACjD,GAAG,EAAE;wBACH,WAAW,EAAE,4CAA4C;wBACzD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;4BACX,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;4BACtB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;4BACxB,OAAO,IAAI,CAAC;wBACd,CAAC;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/no-unsupported-formats.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const noUnsupportedFormats: Rule;

package/dist/rules/no-unsupported-formats.js

@@ -0,0 +1,39 @@
+import { walkSchema } from '../utils/schema-walker.js';
+const UNSUPPORTED_FORMATS = new Set([
+    'uri-reference', 'iri', 'iri-reference',
+    'idn-email', 'idn-hostname',
+    'json-pointer', 'relative-json-pointer',
+    'regex',
+]);
+export const noUnsupportedFormats = {
+    id: 'no-unsupported-formats',
+    severity: 'warning',
+    description: 'Some `format` values are not widely supported and may be rejected by strict clients.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            if (typeof schema.format === 'string' && UNSUPPORTED_FORMATS.has(schema.format)) {
+                const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+                diagnostics.push({
+                    ruleId: 'no-unsupported-formats',
+                    severity: 'warning',
+                    message: `Format "${schema.format}" at "${diagnosticPath}" is not widely supported across MCP clients. Use a plain string without format validation.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    fix: {
+                        description: `Remove the \`format: "${schema.format}"\` field`,
+                        apply: (s) => {
+                            const copy = { ...s };
+                            delete copy['format'];
+                            return copy;
+                        },
+                    },
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=no-unsupported-formats.js.map

package/dist/rules/no-unsupported-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unsupported-formats.js","sourceRoot":"","sources":["../../src/rules/no-unsupported-formats.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,eAAe,EAAE,KAAK,EAAE,eAAe;IACvC,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,uBAAuB;IACvC,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,EAAE,EAAE,wBAAwB;IAC5B,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,sFAAsF;IACnG,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChF,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,wBAAwB;oBAChC,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,WAAW,MAAM,CAAC,MAAM,SAAS,cAAc,6FAA6F;oBACrJ,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;oBACjD,GAAG,EAAE;wBACH,WAAW,EAAE,yBAAyB,MAAM,CAAC,MAAM,WAAW;wBAC9D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;4BACX,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;4BACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC;4BACtB,OAAO,IAAI,CAAC;wBACd,CAAC;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/valid-json-schema-subset.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from '../core/rule.js';
+export declare const validJsonSchemaSubset: Rule;

package/dist/rules/valid-json-schema-subset.js

@@ -0,0 +1,43 @@
+import { walkSchema } from '../utils/schema-walker.js';
+const UNSUPPORTED_KEYWORDS = [
+    'if', 'then', 'else',
+    'oneOf', 'anyOf', 'allOf', 'not',
+    'patternProperties', 'additionalItems',
+    'dependencies', '$dynamicRef',
+];
+export const validJsonSchemaSubset = {
+    id: 'valid-json-schema-subset',
+    severity: 'error',
+    description: 'MCP tool schemas should use a simple JSON Schema subset. Advanced keywords are not reliably supported.',
+    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+    check(tool, _context) {
+        const diagnostics = [];
+        walkSchema(tool.inputSchema, (schema, path) => {
+            const diagnosticPath = path ? `inputSchema.${path}` : 'inputSchema';
+            for (const keyword of UNSUPPORTED_KEYWORDS) {
+                if (keyword in schema) {
+                    diagnostics.push({
+                        ruleId: 'valid-json-schema-subset',
+                        severity: 'error',
+                        message: `Keyword "${keyword}" at "${diagnosticPath}" is not in the MCP-supported JSON Schema subset and is not reliably supported across clients.`,
+                        toolName: tool.name,
+                        path: diagnosticPath,
+                        clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                    });
+                }
+            }
+            if (typeof schema.$ref === 'string' && !schema.$ref.startsWith('#')) {
+                diagnostics.push({
+                    ruleId: 'valid-json-schema-subset',
+                    severity: 'error',
+                    message: `External $ref "${schema.$ref}" at "${diagnosticPath}" is not supported. Only internal refs (#/...) are allowed.`,
+                    toolName: tool.name,
+                    path: diagnosticPath,
+                    clients: ['claude', 'cursor', 'gemini', 'vscode'],
+                });
+            }
+        });
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=valid-json-schema-subset.js.map

package/dist/rules/valid-json-schema-subset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valid-json-schema-subset.js","sourceRoot":"","sources":["../../src/rules/valid-json-schema-subset.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,MAAM,EAAE,MAAM;IACpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK;IAChC,mBAAmB,EAAE,iBAAiB;IACtC,cAAc,EAAE,aAAa;CACrB,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAS;IACzC,EAAE,EAAE,0BAA0B;IAC9B,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,wGAAwG;IACrH,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAEjD,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;YAEpE,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;gBAC3C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;oBACtB,WAAW,CAAC,IAAI,CAAC;wBACf,MAAM,EAAE,0BAA0B;wBAClC,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,YAAY,OAAO,SAAS,cAAc,gGAAgG;wBACnJ,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,IAAI,EAAE,cAAc;wBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;qBAClD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC;oBACf,MAAM,EAAE,0BAA0B;oBAClC,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,kBAAkB,MAAM,CAAC,IAAI,SAAS,cAAc,6DAA6D;oBAC1H,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;iBAClD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/utils/schema-walker.d.ts

@@ -0,0 +1,3 @@
+import type { JSONSchema } from '../core/rule.js';
+export type SchemaVisitor = (schema: JSONSchema, path: string) => void;
+export declare function walkSchema(schema: JSONSchema, visitor: SchemaVisitor, path?: string): void;

package/dist/utils/schema-walker.js

@@ -0,0 +1,52 @@
+function walkInternal(schema, visitor, path, visited) {
+    if (!schema || typeof schema !== 'object')
+        return;
+    if (visited.has(schema))
+        return;
+    visited.add(schema);
+    visitor(schema, path);
+    if (schema.properties) {
+        for (const [key, value] of Object.entries(schema.properties)) {
+            const childPath = path ? `${path}.properties.${key}` : `properties.${key}`;
+            walkInternal(value, visitor, childPath, visited);
+        }
+    }
+    if (schema.items) {
+        if (Array.isArray(schema.items)) {
+            schema.items.forEach((item, i) => {
+                const childPath = path ? `${path}.items[${i}]` : `items[${i}]`;
+                walkInternal(item, visitor, childPath, visited);
+            });
+        }
+        else {
+            walkInternal(schema.items, visitor, path ? `${path}.items` : 'items', visited);
+        }
+    }
+    for (const kw of ['anyOf', 'oneOf', 'allOf']) {
+        const arr = schema[kw];
+        if (Array.isArray(arr)) {
+            arr.forEach((s, i) => {
+                const childPath = path ? `${path}.${kw}[${i}]` : `${kw}[${i}]`;
+                walkInternal(s, visitor, childPath, visited);
+            });
+        }
+    }
+    if (schema.not)
+        walkInternal(schema.not, visitor, path ? `${path}.not` : 'not', visited);
+    if (schema.if)
+        walkInternal(schema.if, visitor, path ? `${path}.if` : 'if', visited);
+    if (schema.then)
+        walkInternal(schema.then, visitor, path ? `${path}.then` : 'then', visited);
+    if (schema.else)
+        walkInternal(schema.else, visitor, path ? `${path}.else` : 'else', visited);
+    if (schema.patternProperties) {
+        for (const [pattern, value] of Object.entries(schema.patternProperties)) {
+            const childPath = path ? `${path}.patternProperties.${pattern}` : `patternProperties.${pattern}`;
+            walkInternal(value, visitor, childPath, visited);
+        }
+    }
+}
+export function walkSchema(schema, visitor, path = '') {
+    walkInternal(schema, visitor, path, new WeakSet());
+}
+//# sourceMappingURL=schema-walker.js.map

package/dist/utils/schema-walker.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "mcp-lint",
+  "version": "0.1.0",
+  "description": "Lint MCP server tool schemas for cross-client compatibility",
+  "type": "module",
+  "bin": {
+    "mcp-lint": "./dist/index.js"
+  },
+  "main": "./dist/core/engine.js",
+  "types": "./dist/core/engine.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "lint",
+    "schema",
+    "validation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "yaml": "^2.8.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
+  }
+}