mcp-tool-lint 0.1.0

package/README.md

@@ -0,0 +1,269 @@
+# mcp-tool-lint
+
+Static linter for [MCP (Model Context Protocol)](https://modelcontextprotocol.io) tool definitions. Catches quality defects before deployment so AI agents use your tools correctly.
+
+A February 2026 research paper analyzing 1,899 MCP tools from 200 servers found that **97.1% have at least one quality defect** -- unclear descriptions, missing parameter documentation, vague naming, and more. These defects cause AI agents to misuse tools, leading to failed actions and poor user experiences.
+
+`mcp-tool-lint` catches these issues statically, before your tools reach production.
+
+## Install
+
+```bash
+npm install mcp-tool-lint
+```
+
+## Quick Start
+
+### CLI
+
+```bash
+# Lint a JSON file of tool definitions
+npx mcp-tool-lint tools.json
+```
+
+The JSON file should contain a single tool object or an array of tool objects:
+
+```json
+[
+  {
+    "name": "get_user",
+    "description": "Retrieves a user by their unique identifier from the database",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "userId": { "type": "string", "description": "The unique user ID" }
+      },
+      "required": ["userId"]
+    }
+  }
+]
+```
+
+Output:
+
+```
+✓ get_user (0 issues)
+```
+
+### Programmatic API
+
+```typescript
+import { lintTools, validateTools } from 'mcp-tool-lint';
+
+const tools = [
+  {
+    name: 'get_data',
+    description: 'gets data',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string' },
+      },
+    },
+  },
+];
+
+// Get detailed results
+const results = lintTools(tools);
+for (const result of results) {
+  console.log(`${result.tool}: ${result.passed ? 'PASSED' : 'FAILED'}`);
+  for (const issue of result.issues) {
+    console.log(`  [${issue.severity}] ${issue.rule}: ${issue.message}`);
+  }
+}
+
+// Quick pass/fail check (true if no error-severity issues)
+const ok = validateTools(tools);
+```
+
+## Rules
+
+### `description-length`
+
+**Severity:** warn (error if under 10 characters)
+
+Tool descriptions must be at least 20 characters. Descriptions under 10 characters are flagged as errors.
+
+| Status | Example |
+|--------|---------|
+| Pass | `"Searches the product catalog by keyword and returns matching items"` |
+| Warn | `"Gets user data"` (15 chars) |
+| Error | `"Get data"` (8 chars) |
+
+### `require-param-descriptions`
+
+**Severity:** warn
+
+Every property in `inputSchema.properties` should have a `description` field. Without descriptions, AI agents must guess what values to pass.
+
+| Status | Example |
+|--------|---------|
+| Pass | `{ "userId": { "type": "string", "description": "The unique user ID" } }` |
+| Fail | `{ "userId": { "type": "string" } }` |
+
+### `no-vague-verbs`
+
+**Severity:** warn
+
+Descriptions should not start with or prominently use vague verbs. The following are flagged:
+
+- "does", "handles", "manages", "works with", "interacts with", "deals with", "takes care of", "is responsible for", "processes"
+
+Use specific verbs like: creates, returns, searches, deletes, updates, fetches, sends, validates, transforms, filters.
+
+| Status | Example |
+|--------|---------|
+| Pass | `"Creates a payment record in the billing system"` |
+| Fail | `"Handles payments for the checkout flow"` |
+
+### `require-required-array`
+
+**Severity:** warn
+
+If `inputSchema.properties` has entries, `inputSchema.required` should be present (even if empty `[]`) to make intent explicit. Without it, consumers cannot distinguish "all optional" from "the author forgot."
+
+| Status | Example |
+|--------|---------|
+| Pass | `{ "properties": { "id": ... }, "required": ["id"] }` |
+| Pass | `{ "properties": { "id": ... }, "required": [] }` |
+| Fail | `{ "properties": { "id": ... } }` (no required field) |
+
+### `description-has-verb`
+
+**Severity:** warn
+
+Descriptions should contain at least one action verb to convey what the tool does. Checked against a list of 200+ common action verbs.
+
+| Status | Example |
+|--------|---------|
+| Pass | `"Creates a new user account"` |
+| Fail | `"A utility for user data in the system"` |
+
+### `no-duplicate-names`
+
+**Severity:** error
+
+When linting multiple tools, no two tools should have the same `name`. Duplicate names cause ambiguity for AI agents selecting tools.
+
+| Status | Example |
+|--------|---------|
+| Pass | Tools named `get_user`, `create_user`, `delete_user` |
+| Fail | Two tools both named `get_user` |
+
+## CLI Usage
+
+```bash
+# Basic usage
+npx mcp-tool-lint tools.json
+
+# Show help
+npx mcp-tool-lint --help
+
+# Show version
+npx mcp-tool-lint --version
+```
+
+Exit codes:
+- `0` -- all tools pass (warnings are OK)
+- `1` -- at least one tool has an error-severity issue
+
+Output format:
+
+```
+✗ get_data (2 issues)
+  warn  [description-length] Description is too short (8 chars, min 20)
+  warn  [require-param-descriptions] Parameter 'id' has no description
+✓ create_user (0 issues)
+```
+
+## Custom Rules
+
+You can pass custom rules to `lintTools`:
+
+```typescript
+import { lintTools, Rule, McpToolDefinition, LintIssue } from 'mcp-tool-lint';
+
+const noUnderscores: Rule = {
+  name: 'no-underscores-in-name',
+  description: 'Tool names should use camelCase, not snake_case',
+  check(tool: McpToolDefinition): LintIssue[] {
+    if (tool.name.includes('_')) {
+      return [{
+        rule: 'no-underscores-in-name',
+        severity: 'warn',
+        message: `Tool name "${tool.name}" uses underscores; consider camelCase`,
+        tool: tool.name,
+        field: 'name',
+      }];
+    }
+    return [];
+  },
+};
+
+const results = lintTools(tools, { rules: [noUnderscores] });
+```
+
+You can also override severity for built-in rules:
+
+```typescript
+const results = lintTools(tools, {
+  severity: {
+    'description-length': 'error',      // Upgrade to error
+    'require-param-descriptions': 'info', // Downgrade to info
+  },
+});
+```
+
+## API Reference
+
+### `lintTool(tool, opts?)`
+
+Lint a single tool definition. Returns a `LintResult`.
+
+### `lintTools(tools, opts?)`
+
+Lint an array of tool definitions. Returns `LintResult[]`. Cross-tool rules (like `no-duplicate-names`) operate across the full set.
+
+### `validateTools(tools, opts?)`
+
+Convenience function. Returns `true` if all tools pass (no error-severity issues).
+
+### Types
+
+```typescript
+interface McpToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties?: Record<string, { type?: string; description?: string; [key: string]: unknown }>;
+    required?: string[];
+  };
+}
+
+type Severity = 'error' | 'warn' | 'info';
+
+interface LintIssue {
+  rule: string;
+  severity: Severity;
+  message: string;
+  tool: string;
+  field?: string;
+}
+
+interface LintResult {
+  tool: string;
+  issues: LintIssue[];
+  passed: boolean; // true if no 'error' severity issues
+}
+
+interface Rule {
+  name: string;
+  description: string;
+  check(tool: McpToolDefinition, allTools?: McpToolDefinition[]): LintIssue[];
+}
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { lintTools } from './linter.js';
+const RESET = '\x1b[0m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const CYAN = '\x1b[36m';
+const BOLD = '\x1b[1m';
+function colorize(severity) {
+    switch (severity) {
+        case 'error': return RED;
+        case 'warn': return YELLOW;
+        case 'info': return CYAN;
+        default: return RESET;
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(`${BOLD}mcp-tool-lint${RESET} - Static linter for MCP tool definitions\n`);
+        console.log('Usage: mcp-tool-lint <tools.json>\n');
+        console.log('Options:');
+        console.log('  -h, --help     Show this help message');
+        console.log('  -v, --version  Show version\n');
+        console.log('The JSON file should contain a single tool object or an array of tool objects.');
+        process.exit(0);
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log('0.1.0');
+        process.exit(0);
+    }
+    const filePath = resolve(args[0]);
+    let fileContent;
+    try {
+        fileContent = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        console.error(`${RED}Error: Could not read file "${filePath}"${RESET}`);
+        process.exit(1);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fileContent);
+    }
+    catch {
+        console.error(`${RED}Error: Invalid JSON in "${filePath}"${RESET}`);
+        process.exit(1);
+    }
+    const tools = Array.isArray(parsed) ? parsed : [parsed];
+    const results = lintTools(tools);
+    let hasErrors = false;
+    for (const result of results) {
+        const issueCount = result.issues.length;
+        const icon = result.passed ? `${GREEN}\u2713${RESET}` : `${RED}\u2717${RESET}`;
+        const countLabel = issueCount === 1 ? '1 issue' : `${issueCount} issues`;
+        console.log(`${icon} ${BOLD}${result.tool}${RESET} (${countLabel})`);
+        for (const issue of result.issues) {
+            const color = colorize(issue.severity);
+            const severity = issue.severity.padEnd(5);
+            console.log(`  ${color}${severity}${RESET} [${issue.rule}] ${issue.message}`);
+        }
+        if (!result.passed)
+            hasErrors = true;
+    }
+    process.exit(hasErrors ? 1 : 0);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { lintTool, lintTools, validateTools } from './linter.js';
+export type { LintOptions } from './linter.js';
+export { allRules, descriptionLength, requireParamDescriptions, noVagueVerbs, requireRequiredArray, descriptionHasVerb, noDuplicateNames } from './rules/index.js';
+export type { McpToolDefinition, Severity, LintIssue, LintResult, Rule } from './types.js';
+//# 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":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnK,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { lintTool, lintTools, validateTools } from './linter.js';
+export { allRules, descriptionLength, requireParamDescriptions, noVagueVerbs, requireRequiredArray, descriptionHasVerb, noDuplicateNames } from './rules/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/linter.d.ts

@@ -0,0 +1,11 @@
+import { McpToolDefinition, LintResult, Rule, Severity } from './types.js';
+export interface LintOptions {
+    rules?: Rule[];
+    severity?: {
+        [ruleName: string]: Severity;
+    };
+}
+export declare function lintTool(tool: McpToolDefinition, opts?: LintOptions, allTools?: McpToolDefinition[]): LintResult;
+export declare function lintTools(tools: McpToolDefinition[], opts?: LintOptions): LintResult[];
+export declare function validateTools(tools: McpToolDefinition[], opts?: LintOptions): boolean;
+//# sourceMappingURL=linter.d.ts.map

package/dist/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAa,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtF,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC9B,CAAC;CACH;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,GAAG,UAAU,CAqBhH;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,EAAE,CAEtF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAGrF"}

package/dist/linter.js

@@ -0,0 +1,28 @@
+import { allRules } from './rules/index.js';
+export function lintTool(tool, opts, allTools) {
+    const rules = opts?.rules ?? allRules;
+    const severityOverrides = opts?.severity ?? {};
+    const issues = [];
+    for (const rule of rules) {
+        const ruleIssues = rule.check(tool, allTools);
+        for (const issue of ruleIssues) {
+            if (severityOverrides[issue.rule]) {
+                issue.severity = severityOverrides[issue.rule];
+            }
+            issues.push(issue);
+        }
+    }
+    return {
+        tool: tool.name,
+        issues,
+        passed: !issues.some(i => i.severity === 'error'),
+    };
+}
+export function lintTools(tools, opts) {
+    return tools.map(tool => lintTool(tool, opts, tools));
+}
+export function validateTools(tools, opts) {
+    const results = lintTools(tools, opts);
+    return results.every(r => r.passed);
+}
+//# sourceMappingURL=linter.js.map

package/dist/linter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.js","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAS5C,MAAM,UAAU,QAAQ,CAAC,IAAuB,EAAE,IAAkB,EAAE,QAA8B;IAClG,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,QAAQ,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IAE/C,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM;QACN,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAA0B,EAAE,IAAkB;IACtE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAA0B,EAAE,IAAkB;IAC1E,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/rules/description-has-verb.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const descriptionHasVerb: Rule;
+//# sourceMappingURL=description-has-verb.d.ts.map

package/dist/rules/description-has-verb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-has-verb.d.ts","sourceRoot":"","sources":["../../src/rules/description-has-verb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAuCjE,eAAO,MAAM,kBAAkB,EAAE,IAyBhC,CAAC"}

package/dist/rules/description-has-verb.js

@@ -0,0 +1,59 @@
+const ACTION_VERBS = [
+    'accept', 'add', 'aggregate', 'analyze', 'append', 'apply', 'authenticate',
+    'build', 'calculate', 'cancel', 'capture', 'check', 'clear', 'clone', 'close',
+    'collect', 'combine', 'compare', 'compile', 'compose', 'compute', 'configure',
+    'connect', 'convert', 'copy', 'count', 'create', 'decode', 'decrypt', 'delete',
+    'deliver', 'deploy', 'detect', 'determine', 'disable', 'disconnect', 'display',
+    'download', 'emit', 'enable', 'encode', 'encrypt', 'establish', 'evaluate',
+    'execute', 'export', 'extract', 'fetch', 'filter', 'find', 'flush', 'format',
+    'forward', 'generate', 'get', 'grant', 'group', 'import', 'index', 'initialize',
+    'inject', 'insert', 'inspect', 'install', 'invoke', 'iterate', 'join', 'launch',
+    'link', 'list', 'listen', 'load', 'locate', 'log', 'look', 'map', 'match',
+    'measure', 'merge', 'migrate', 'modify', 'monitor', 'move', 'normalize',
+    'notify', 'open', 'optimize', 'orchestrate', 'output', 'override', 'parse',
+    'patch', 'pause', 'perform', 'persist', 'ping', 'poll', 'populate', 'post',
+    'print', 'provision', 'publish', 'pull', 'purge', 'push', 'put', 'query',
+    'queue', 'read', 'receive', 'record', 'redirect', 'reduce', 'refresh',
+    'register', 'reject', 'reload', 'remove', 'rename', 'render', 'replace',
+    'replicate', 'report', 'request', 'reset', 'resize', 'resolve', 'restart',
+    'restore', 'retrieve', 'return', 'revoke', 'rollback', 'rotate', 'route',
+    'run', 'save', 'scan', 'schedule', 'scrape', 'search', 'select', 'send',
+    'serialize', 'set', 'shut', 'sign', 'snapshot', 'sort', 'spawn', 'split',
+    'start', 'stop', 'store', 'stream', 'submit', 'subscribe', 'summarize',
+    'suspend', 'sync', 'terminate', 'test', 'toggle', 'trace', 'track',
+    'transfer', 'transform', 'translate', 'trigger', 'truncate', 'uninstall',
+    'unlink', 'unlock', 'unsubscribe', 'update', 'upgrade', 'upload', 'upsert',
+    'validate', 'verify', 'watch', 'write',
+    // Past tense / -s / -ing forms will be matched by stemming below
+    'creates', 'returns', 'searches', 'deletes', 'updates', 'fetches', 'sends',
+    'validates', 'transforms', 'filters', 'reads', 'writes', 'lists', 'finds',
+    'checks', 'runs', 'sets', 'gets', 'adds', 'removes', 'moves', 'copies',
+    'loads', 'saves', 'starts', 'stops', 'opens', 'closes', 'connects',
+    'disconnects', 'enables', 'disables', 'parses', 'formats', 'converts',
+    'computes', 'calculates', 'generates', 'extracts', 'inserts', 'selects',
+];
+const verbSet = new Set(ACTION_VERBS);
+export const descriptionHasVerb = {
+    name: 'description-has-verb',
+    description: 'Description should contain at least one action verb',
+    check(tool) {
+        const issues = [];
+        const desc = (tool.description || '').toLowerCase();
+        const words = desc.split(/\s+/);
+        const hasVerb = words.some(word => {
+            const cleaned = word.replace(/[^a-z]/g, '');
+            return verbSet.has(cleaned);
+        });
+        if (!hasVerb) {
+            issues.push({
+                rule: 'description-has-verb',
+                severity: 'warn',
+                message: 'Description should contain at least one action verb (e.g., "creates", "returns", "searches")',
+                tool: tool.name,
+                field: 'description',
+            });
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=description-has-verb.js.map

package/dist/rules/description-has-verb.js.map

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

package/dist/rules/description-length.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const descriptionLength: Rule;
+//# sourceMappingURL=description-length.d.ts.map

package/dist/rules/description-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-length.d.ts","sourceRoot":"","sources":["../../src/rules/description-length.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,IA4B/B,CAAC"}

package/dist/rules/description-length.js

@@ -0,0 +1,29 @@
+export const descriptionLength = {
+    name: 'description-length',
+    description: 'Tool description must be at least 20 characters (error if < 10)',
+    check(tool) {
+        const issues = [];
+        const desc = (tool.description || '').trim();
+        const len = desc.length;
+        if (len < 10) {
+            issues.push({
+                rule: 'description-length',
+                severity: 'error',
+                message: `Description is too short (${len} chars, min 10)`,
+                tool: tool.name,
+                field: 'description',
+            });
+        }
+        else if (len < 20) {
+            issues.push({
+                rule: 'description-length',
+                severity: 'warn',
+                message: `Description is too short (${len} chars, min 20)`,
+                tool: tool.name,
+                field: 'description',
+            });
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=description-length.js.map

package/dist/rules/description-length.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-length.js","sourceRoot":"","sources":["../../src/rules/description-length.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,iEAAiE;IAC9E,KAAK,CAAC,IAAuB;QAC3B,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAExB,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,6BAA6B,GAAG,iBAAiB;gBAC1D,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,6BAA6B,GAAG,iBAAiB;gBAC1D,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/rules/index.d.ts

@@ -0,0 +1,10 @@
+import { Rule } from '../types.js';
+import { descriptionLength } from './description-length.js';
+import { requireParamDescriptions } from './require-param-descriptions.js';
+import { noVagueVerbs } from './no-vague-verbs.js';
+import { requireRequiredArray } from './require-required-array.js';
+import { descriptionHasVerb } from './description-has-verb.js';
+import { noDuplicateNames } from './no-duplicate-names.js';
+export declare const allRules: Rule[];
+export { descriptionLength, requireParamDescriptions, noVagueVerbs, requireRequiredArray, descriptionHasVerb, noDuplicateNames, };
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,eAAO,MAAM,QAAQ,EAAE,IAAI,EAO1B,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/dist/rules/index.js

@@ -0,0 +1,16 @@
+import { descriptionLength } from './description-length.js';
+import { requireParamDescriptions } from './require-param-descriptions.js';
+import { noVagueVerbs } from './no-vague-verbs.js';
+import { requireRequiredArray } from './require-required-array.js';
+import { descriptionHasVerb } from './description-has-verb.js';
+import { noDuplicateNames } from './no-duplicate-names.js';
+export const allRules = [
+    descriptionLength,
+    requireParamDescriptions,
+    noVagueVerbs,
+    requireRequiredArray,
+    descriptionHasVerb,
+    noDuplicateNames,
+];
+export { descriptionLength, requireParamDescriptions, noVagueVerbs, requireRequiredArray, descriptionHasVerb, noDuplicateNames, };
+//# 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,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAW;IAC9B,iBAAiB;IACjB,wBAAwB;IACxB,YAAY;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;CACjB,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/dist/rules/no-duplicate-names.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const noDuplicateNames: Rule;
+//# sourceMappingURL=no-duplicate-names.d.ts.map

package/dist/rules/no-duplicate-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-duplicate-names.d.ts","sourceRoot":"","sources":["../../src/rules/no-duplicate-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAEjE,eAAO,MAAM,gBAAgB,EAAE,IAsB9B,CAAC"}

package/dist/rules/no-duplicate-names.js

@@ -0,0 +1,21 @@
+export const noDuplicateNames = {
+    name: 'no-duplicate-names',
+    description: 'Tool names must be unique across the set',
+    check(tool, allTools) {
+        const issues = [];
+        if (!allTools || allTools.length <= 1)
+            return issues;
+        const duplicates = allTools.filter(t => t !== tool && t.name === tool.name);
+        if (duplicates.length > 0) {
+            issues.push({
+                rule: 'no-duplicate-names',
+                severity: 'error',
+                message: `Duplicate tool name "${tool.name}" found`,
+                tool: tool.name,
+                field: 'name',
+            });
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=no-duplicate-names.js.map

package/dist/rules/no-duplicate-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-duplicate-names.js","sourceRoot":"","sources":["../../src/rules/no-duplicate-names.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,0CAA0C;IACvD,KAAK,CAAC,IAAuB,EAAE,QAA8B;QAC3D,MAAM,MAAM,GAAgB,EAAE,CAAC;QAE/B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QAErD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,wBAAwB,IAAI,CAAC,IAAI,SAAS;gBACnD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/rules/no-vague-verbs.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const noVagueVerbs: Rule;
+//# sourceMappingURL=no-vague-verbs.d.ts.map

package/dist/rules/no-vague-verbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-vague-verbs.d.ts","sourceRoot":"","sources":["../../src/rules/no-vague-verbs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAmBjE,eAAO,MAAM,YAAY,EAAE,IAuB1B,CAAC"}

package/dist/rules/no-vague-verbs.js

@@ -0,0 +1,38 @@
+const VAGUE_PATTERNS = [
+    'does',
+    'handles',
+    'manages',
+    'works with',
+    'interacts with',
+    'deals with',
+    'takes care of',
+    'is responsible for',
+    'processes',
+];
+const SPECIFIC_VERB_SUGGESTIONS = [
+    'creates', 'returns', 'searches', 'deletes', 'updates',
+    'fetches', 'sends', 'validates', 'transforms', 'filters',
+];
+export const noVagueVerbs = {
+    name: 'no-vague-verbs',
+    description: 'Description should not use vague verbs like "handles", "manages", "does"',
+    check(tool) {
+        const issues = [];
+        const desc = (tool.description || '').toLowerCase();
+        for (const pattern of VAGUE_PATTERNS) {
+            const regex = new RegExp(`\\b${pattern}\\b`, 'i');
+            if (regex.test(desc)) {
+                issues.push({
+                    rule: 'no-vague-verbs',
+                    severity: 'warn',
+                    message: `Description uses vague verb "${pattern}". Use specific verbs like: ${SPECIFIC_VERB_SUGGESTIONS.join(', ')}`,
+                    tool: tool.name,
+                    field: 'description',
+                });
+                break; // One issue per tool is enough
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=no-vague-verbs.js.map

package/dist/rules/no-vague-verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-vague-verbs.js","sourceRoot":"","sources":["../../src/rules/no-vague-verbs.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG;IACrB,MAAM;IACN,SAAS;IACT,SAAS;IACT,YAAY;IACZ,gBAAgB;IAChB,YAAY;IACZ,eAAe;IACf,oBAAoB;IACpB,WAAW;CACZ,CAAC;AAEF,MAAM,yBAAyB,GAAG;IAChC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS;IACtD,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS;CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,0EAA0E;IACvF,KAAK,CAAC,IAAuB;QAC3B,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAEpD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,gBAAgB;oBACtB,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,gCAAgC,OAAO,+BAA+B,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACrH,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,aAAa;iBACrB,CAAC,CAAC;gBACH,MAAM,CAAC,+BAA+B;YACxC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/rules/require-param-descriptions.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const requireParamDescriptions: Rule;
+//# sourceMappingURL=require-param-descriptions.d.ts.map

package/dist/rules/require-param-descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-param-descriptions.d.ts","sourceRoot":"","sources":["../../src/rules/require-param-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAEjE,eAAO,MAAM,wBAAwB,EAAE,IAuBtC,CAAC"}

package/dist/rules/require-param-descriptions.js

@@ -0,0 +1,23 @@
+export const requireParamDescriptions = {
+    name: 'require-param-descriptions',
+    description: 'Every property in inputSchema.properties should have a description',
+    check(tool) {
+        const issues = [];
+        const properties = tool.inputSchema?.properties;
+        if (!properties)
+            return issues;
+        for (const [paramName, paramDef] of Object.entries(properties)) {
+            if (!paramDef.description || paramDef.description.trim().length === 0) {
+                issues.push({
+                    rule: 'require-param-descriptions',
+                    severity: 'warn',
+                    message: `Parameter '${paramName}' has no description`,
+                    tool: tool.name,
+                    field: `inputSchema.properties.${paramName}.description`,
+                });
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=require-param-descriptions.js.map

package/dist/rules/require-param-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-param-descriptions.js","sourceRoot":"","sources":["../../src/rules/require-param-descriptions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,oEAAoE;IACjF,KAAK,CAAC,IAAuB;QAC3B,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAEhD,IAAI,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC;QAE/B,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,4BAA4B;oBAClC,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,cAAc,SAAS,sBAAsB;oBACtD,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,0BAA0B,SAAS,cAAc;iBACzD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/rules/require-required-array.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '../types.js';
+export declare const requireRequiredArray: Rule;
+//# sourceMappingURL=require-required-array.d.ts.map

package/dist/rules/require-required-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-required-array.d.ts","sourceRoot":"","sources":["../../src/rules/require-required-array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgC,MAAM,aAAa,CAAC;AAEjE,eAAO,MAAM,oBAAoB,EAAE,IAqBlC,CAAC"}

package/dist/rules/require-required-array.js

@@ -0,0 +1,21 @@
+export const requireRequiredArray = {
+    name: 'require-required-array',
+    description: 'inputSchema should declare a required array when properties are defined',
+    check(tool) {
+        const issues = [];
+        const properties = tool.inputSchema?.properties;
+        if (properties && Object.keys(properties).length > 0) {
+            if (!Array.isArray(tool.inputSchema.required)) {
+                issues.push({
+                    rule: 'require-required-array',
+                    severity: 'warn',
+                    message: 'inputSchema has properties but no "required" array — declare required fields explicitly (even if empty)',
+                    tool: tool.name,
+                    field: 'inputSchema.required',
+                });
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=require-required-array.js.map

package/dist/rules/require-required-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-required-array.js","sourceRoot":"","sources":["../../src/rules/require-required-array.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAS;IACxC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,yEAAyE;IACtF,KAAK,CAAC,IAAuB;QAC3B,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QAEhD,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,wBAAwB;oBAC9B,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,yGAAyG;oBAClH,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,sBAAsB;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, {
+            type?: string;
+            description?: string;
+            enum?: string[];
+            [key: string]: unknown;
+        }>;
+        required?: string[];
+    };
+}
+export type Severity = 'error' | 'warn' | 'info';
+export interface LintIssue {
+    rule: string;
+    severity: Severity;
+    message: string;
+    tool: string;
+    field?: string;
+}
+export interface LintResult {
+    tool: string;
+    issues: LintIssue[];
+    passed: boolean;
+}
+export interface Rule {
+    name: string;
+    description: string;
+    check(tool: McpToolDefinition, allTools?: McpToolDefinition[]): LintIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC,CAAC;QACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,EAAE,CAAC;CAC7E"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "mcp-tool-lint",
+  "version": "0.1.0",
+  "description": "Static linter for MCP tool definitions — catch quality defects before deployment",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-tool-lint": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc && node --experimental-strip-types --no-warnings --test tests/*.test.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "linting",
+    "tools",
+    "ai",
+    "claude"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}