mcp-lint 0.6.2 → 0.8.0

package/dist/rules/tool-name.js

@@ -0,0 +1,44 @@
+const CLIENTS = [
+    'claude', 'cursor', 'gemini', 'vscode', 'windsurf', 'cline', 'openai', 'continue',
+];
+// OpenAI and Azure: ^[A-Za-z0-9_-]{1,64}$
+// Gemini also requires the first character to be a letter or underscore.
+const SAFE_NAME = /^[A-Za-z0-9_-]{1,64}$/;
+const LEADING_DIGIT = /^[0-9]/;
+export const toolNameClientSafe = {
+    id: 'tool-name/client-safe',
+    severity: 'error',
+    description: 'Tool names must be 1–64 characters of letters, digits, underscores, or hyphens, and should not start with a digit.',
+    clients: CLIENTS,
+    docs: {
+        why: 'OpenAI and Azure reject a tool name outside ^[A-Za-z0-9_-]{1,64}$. A space, slash, or dot makes the tool disappear. Gemini also refuses a name that starts with a digit.',
+        badExample: { name: 'search files' },
+        goodExample: { name: 'search_files' },
+        fixNote: 'Rename the tool. Use letters, digits, underscores, or hyphens, start with a letter or underscore, and stay within 64 characters.',
+    },
+    check(tool, _context) {
+        const name = tool.name ?? '';
+        if (!SAFE_NAME.test(name)) {
+            return [{
+                    ruleId: 'tool-name/client-safe',
+                    severity: 'error',
+                    message: `Tool name "${name}" is not safe across clients. Use 1–64 characters: letters, digits, underscore, or hyphen.`,
+                    toolName: name || '(unnamed)',
+                    path: 'name',
+                    clients: ['claude', 'openai', 'gemini'],
+                }];
+        }
+        if (LEADING_DIGIT.test(name)) {
+            return [{
+                    ruleId: 'tool-name/client-safe',
+                    severity: 'warning',
+                    message: `Tool name "${name}" starts with a digit. Gemini requires a letter or an underscore first.`,
+                    toolName: name,
+                    path: 'name',
+                    clients: ['gemini'],
+                }];
+        }
+        return [];
+    },
+};
+//# sourceMappingURL=tool-name.js.map

package/dist/rules/tool-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name.js","sourceRoot":"","sources":["../../src/rules/tool-name.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,GAAe;IAC1B,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU;CAClF,CAAC;AAEF,0CAA0C;AAC1C,yEAAyE;AACzE,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAC1C,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,EAAE,EAAE,uBAAuB;IAC3B,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,oHAAoH;IACjI,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE,0KAA0K;QAC/K,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;QACpC,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;QACrC,OAAO,EAAE,kIAAkI;KAC5I;IAED,KAAK,CAAC,IAAa,EAAE,QAAqB;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC;oBACN,MAAM,EAAE,uBAAuB;oBAC/B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,cAAc,IAAI,4FAA4F;oBACvH,QAAQ,EAAE,IAAI,IAAI,WAAW;oBAC7B,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;iBACxC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC;oBACN,MAAM,EAAE,uBAAuB;oBAC/B,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,cAAc,IAAI,yEAAyE;oBACpG,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

package/dist/snapshot/serialize.d.ts

@@ -0,0 +1,2 @@
+import type { MCPTool } from '../core/rule.js';
+export declare function serializeTools(tools: MCPTool[]): string;

package/dist/snapshot/serialize.js

@@ -0,0 +1,17 @@
+export function serializeTools(tools) {
+    const sorted = [...tools].sort((left, right) => left.name.localeCompare(right.name));
+    const shaped = sorted.map((tool) => {
+        const record = { name: tool.name };
+        if (tool.title)
+            record.title = tool.title;
+        if (tool.description)
+            record.description = tool.description;
+        record.inputSchema = tool.inputSchema ?? {};
+        if (tool.annotations && Object.keys(tool.annotations).length > 0) {
+            record.annotations = tool.annotations;
+        }
+        return record;
+    });
+    return `${JSON.stringify(shaped, null, 2)}\n`;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/snapshot/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/snapshot/serialize.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1C,IAAI,IAAI,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5D,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}

package/examples/github-action.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Lint MCP tool schemas
-        uses: robert19001-cmyk/mcp-lint@v0.6.2
+        uses: robert19001-cmyk/mcp-lint@v0.8.0
         with:
           input: tools.json
           severity: warning

package/examples/names/unsafe.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "search files",
+    "description": "Search the workspace.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "q": { "type": "string", "description": "Text to find" }
+      }
+    }
+  },
+  {
+    "name": "repo/read",
+    "description": "Read one file.",
+    "inputSchema": { "type": "object", "properties": {} }
+  },
+  {
+    "name": "9tools",
+    "description": "List tools.",
+    "inputSchema": { "type": "object", "properties": {} }
+  }
+]

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "mcp-lint",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "mcpName": "io.github.robert19001-cmyk/mcp-lint",
-  "description": "Lint MCP server tool schemas for cross-client compatibility, runtime preflight, and agent recovery from tool failures",
+  "description": "Lint MCP tool schemas before they break Claude, Cursor, Gemini, or OpenAI. Run npx mcp-lint.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -62,7 +62,11 @@
     "recover",
     "agent-safety",
     "policy",
-    "guardrails"
+    "guardrails",
+    "claude",
+    "cursor",
+    "openai",
+    "gemini"
   ],
   "license": "MIT",
   "engines": {