mcp-lint 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/README.md +26 -5
  2. package/dist/audit/format.d.ts +5 -0
  3. package/dist/audit/format.js +246 -0
  4. package/dist/audit/format.js.map +1 -0
  5. package/dist/audit/index.d.ts +6 -0
  6. package/dist/audit/index.js +4 -0
  7. package/dist/audit/index.js.map +1 -0
  8. package/dist/audit/report.d.ts +268 -0
  9. package/dist/audit/report.js +327 -0
  10. package/dist/audit/report.js.map +1 -0
  11. package/dist/audit/tokens.d.ts +53 -0
  12. package/dist/audit/tokens.js +131 -0
  13. package/dist/audit/tokens.js.map +1 -0
  14. package/dist/cli/commands/check.js +8 -1
  15. package/dist/cli/commands/check.js.map +1 -1
  16. package/dist/cli/commands/compat.js +4 -2
  17. package/dist/cli/commands/compat.js.map +1 -1
  18. package/dist/cli/commands/fix.js +6 -5
  19. package/dist/cli/commands/fix.js.map +1 -1
  20. package/dist/cli/commands/report.d.ts +12 -0
  21. package/dist/cli/commands/report.js +76 -0
  22. package/dist/cli/commands/report.js.map +1 -0
  23. package/dist/core/compat-matrix.d.ts +1 -0
  24. package/dist/core/compat-matrix.js +2 -1
  25. package/dist/core/compat-matrix.js.map +1 -1
  26. package/dist/core/diagnostic.d.ts +3 -1
  27. package/dist/core/engine.d.ts +1 -0
  28. package/dist/core/engine.js +33 -17
  29. package/dist/core/engine.js.map +1 -1
  30. package/dist/core/fixer.js +4 -3
  31. package/dist/core/fixer.js.map +1 -1
  32. package/dist/core/quality-score.d.ts +19 -0
  33. package/dist/core/quality-score.js +52 -13
  34. package/dist/core/quality-score.js.map +1 -1
  35. package/dist/core/rule.d.ts +1 -0
  36. package/dist/discover/files.js +23 -3
  37. package/dist/discover/files.js.map +1 -1
  38. package/dist/index.js +4 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/installed/config.js +15 -0
  41. package/dist/installed/config.js.map +1 -1
  42. package/dist/installed/lint.d.ts +2 -1
  43. package/dist/installed/lint.js +15 -0
  44. package/dist/installed/lint.js.map +1 -1
  45. package/dist/loaders/map-tools.d.ts +1 -0
  46. package/dist/loaders/map-tools.js +2 -0
  47. package/dist/loaders/map-tools.js.map +1 -1
  48. package/dist/loaders/remote-loader.js +2 -1
  49. package/dist/loaders/remote-loader.js.map +1 -1
  50. package/dist/loaders/stdio-loader.js +2 -1
  51. package/dist/loaders/stdio-loader.js.map +1 -1
  52. package/dist/mcp-server.js +1 -1
  53. package/dist/mcp-server.js.map +1 -1
  54. package/dist/preflight/engine.js +27 -0
  55. package/dist/preflight/engine.js.map +1 -1
  56. package/dist/recover/probe.js +2 -1
  57. package/dist/recover/probe.js.map +1 -1
  58. package/dist/rules/client-specific/claude.js +1 -0
  59. package/dist/rules/client-specific/claude.js.map +1 -1
  60. package/dist/rules/client-specific/cline.js +2 -0
  61. package/dist/rules/client-specific/cline.js.map +1 -1
  62. package/dist/rules/client-specific/cursor.js +9 -0
  63. package/dist/rules/client-specific/cursor.js.map +1 -1
  64. package/dist/rules/client-specific/openai.js +1 -0
  65. package/dist/rules/client-specific/openai.js.map +1 -1
  66. package/dist/rules/index.js +3 -1
  67. package/dist/rules/index.js.map +1 -1
  68. package/dist/rules/no-content-encoding.js +1 -0
  69. package/dist/rules/no-content-encoding.js.map +1 -1
  70. package/dist/rules/no-empty-enum.js +1 -0
  71. package/dist/rules/no-empty-enum.js.map +1 -1
  72. package/dist/rules/no-required-false.js +1 -0
  73. package/dist/rules/no-required-false.js.map +1 -1
  74. package/dist/rules/no-unsupported-formats.js +1 -0
  75. package/dist/rules/no-unsupported-formats.js.map +1 -1
  76. package/dist/rules/tool-name.d.ts +9 -1
  77. package/dist/rules/tool-name.js +67 -0
  78. package/dist/rules/tool-name.js.map +1 -1
  79. package/dist/version.d.ts +1 -0
  80. package/dist/version.js +2 -0
  81. package/dist/version.js.map +1 -0
  82. package/examples/github-action.yml +2 -1
  83. package/package.json +7 -1
@@ -5,6 +5,73 @@ const CLIENTS = [
5
5
  // Gemini also requires the first character to be a letter or underscore.
6
6
  const SAFE_NAME = /^[A-Za-z0-9_-]{1,64}$/;
7
7
  const LEADING_DIGIT = /^[0-9]/;
8
+ export function duplicateNameDiagnostics(tools) {
9
+ const counts = new Map();
10
+ for (const tool of tools)
11
+ counts.set(tool.name, (counts.get(tool.name) ?? 0) + 1);
12
+ return [...counts.entries()]
13
+ .filter(([, count]) => count > 1)
14
+ .sort(([a], [b]) => a.localeCompare(b))
15
+ .map(([name, count]) => ({
16
+ ruleId: 'tool-name/duplicate',
17
+ severity: 'error',
18
+ message: `Tool name "${name}" appears ${count} times in this list. Clients call a tool by name, so keep it unique.`,
19
+ toolName: name,
20
+ path: 'name',
21
+ clients: CLIENTS,
22
+ }));
23
+ }
24
+ export function serverCollisionDiagnostics(groups) {
25
+ const owners = new Map();
26
+ for (const group of groups) {
27
+ for (const name of new Set(group.toolNames)) {
28
+ const list = owners.get(name) ?? [];
29
+ list.push(group.serverName);
30
+ owners.set(name, list);
31
+ }
32
+ }
33
+ return [...owners.entries()]
34
+ .filter(([, servers]) => servers.length > 1)
35
+ .sort(([a], [b]) => a.localeCompare(b))
36
+ .map(([name, servers]) => ({
37
+ ruleId: 'tool-name/server-collision',
38
+ severity: 'error',
39
+ message: `Tool "${name}" is exposed by ${servers.join(', ')}. A client cannot tell which server owns the call.`,
40
+ toolName: name,
41
+ path: 'name',
42
+ clients: CLIENTS,
43
+ }));
44
+ }
45
+ export const toolNameDuplicate = {
46
+ id: 'tool-name/duplicate',
47
+ severity: 'error',
48
+ description: 'The same tool name must not appear twice in one tools list.',
49
+ clients: CLIENTS,
50
+ docs: {
51
+ why: 'Clients call a tool by name. Two entries with the same name make the second one unreachable or overwrite the first.',
52
+ badExample: { tools: [{ name: 'search' }, { name: 'search' }] },
53
+ goodExample: { tools: [{ name: 'search_issues' }, { name: 'search_files' }] },
54
+ fixNote: 'Rename one of the tools. mcp-lint emits this from the whole list, because a single tool cannot see its siblings.',
55
+ },
56
+ check() {
57
+ return [];
58
+ },
59
+ };
60
+ export const toolNameServerCollision = {
61
+ id: 'tool-name/server-collision',
62
+ severity: 'error',
63
+ description: 'The same tool name must not be exposed by two installed servers.',
64
+ clients: CLIENTS,
65
+ docs: {
66
+ why: 'A client that connects several MCP servers still calls a tool by name. The same name on two servers does not say which server owns the call.',
67
+ badExample: { servers: [{ name: 'github', tools: ['search'] }, { name: 'gitlab', tools: ['search'] }] },
68
+ goodExample: { servers: [{ name: 'github', tools: ['search_github'] }, { name: 'gitlab', tools: ['search_gitlab'] }] },
69
+ fixNote: 'Rename the tool on one server. This runs for mcp-lint check --installed and --from, after each server has been listed.',
70
+ },
71
+ check() {
72
+ return [];
73
+ },
74
+ };
8
75
  export const toolNameClientSafe = {
9
76
  id: 'tool-name/client-safe',
10
77
  severity: 'error',
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"tool-name.js","sourceRoot":"","sources":["../../src/rules/tool-name.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export declare const VERSION = "0.9.0";
@@ -0,0 +1,2 @@
1
+ export const VERSION = '0.9.0';
2
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
@@ -15,7 +15,8 @@ jobs:
15
15
  - uses: actions/checkout@v4
16
16
 
17
17
  - name: Lint MCP tool schemas
18
- uses: robert19001-cmyk/mcp-lint@v0.8.0
18
+ # Tag v0.9.0. The action installs npm latest, which is still 0.8.0 until that version is published.
19
+ uses: robert19001-cmyk/mcp-lint@v0.9.0
19
20
  with:
20
21
  input: tools.json
21
22
  severity: warning
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-lint",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "mcpName": "io.github.robert19001-cmyk/mcp-lint",
5
5
  "description": "Lint MCP tool schemas before they break Claude, Cursor, Gemini, or OpenAI. Run npx mcp-lint.",
6
6
  "type": "module",
@@ -46,6 +46,10 @@
46
46
  "./mcp-server": {
47
47
  "types": "./dist/mcp-server.d.ts",
48
48
  "default": "./dist/mcp-server.js"
49
+ },
50
+ "./audit": {
51
+ "types": "./dist/audit/index.d.ts",
52
+ "default": "./dist/audit/index.js"
49
53
  }
50
54
  },
51
55
  "files": [
@@ -91,6 +95,8 @@
91
95
  },
92
96
  "devDependencies": {
93
97
  "@types/node": "^25.5.0",
98
+ "@types/three": "^0.187.0",
99
+ "three": "^0.187.0",
94
100
  "typescript": "^6.0.2",
95
101
  "vite": "^8.3.5",
96
102
  "vitest": "^4.1.1"