eslint-plugin-mcp-sdk-security 0.3.1 → 0.4.1
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.
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security" target="blank"><img src="https://eslint.interlace.tools/logos/interlace.svg" alt="Interlace" height="90" /></a>
|
|
2
|
+
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security" target="blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/interlace-dark.svg"><img src="https://eslint.interlace.tools/logos/interlace-light.svg" alt="Interlace" height="90" /></picture></a>
|
|
3
3
|
|
|
4
4
|
<a href="https://modelcontextprotocol.io" target="_blank"><img src="https://eslint.interlace.tools/logos/mcp.svg" alt="Model Context Protocol" height="90" /></a>
|
|
5
5
|
|
|
6
|
-
<a href="https://oxc.rs" target="_blank"><img src="https://eslint.interlace.tools/logos/oxlint.svg" alt="oxlint" height="90" /></a>
|
|
6
|
+
<a href="https://oxc.rs" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/oxlint-dark.svg"><img src="https://eslint.interlace.tools/logos/oxlint-light.svg" alt="oxlint" height="90" /></picture></a>
|
|
7
7
|
|
|
8
|
-
<a href="https://eslint.org" target="_blank"><img src="https://eslint.interlace.tools/logos/eslint.svg" alt="ESLint" height="90" /></a>
|
|
8
|
+
<a href="https://eslint.org" target="_blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/eslint-dark.svg"><img src="https://eslint.interlace.tools/logos/eslint-light.svg" alt="ESLint" height="90" /></picture></a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
@@ -15,6 +15,7 @@
|
|
|
15
15
|
<p align="center">
|
|
16
16
|
<a href="https://www.npmjs.com/package/eslint-plugin-mcp-sdk-security" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-mcp-sdk-security.svg" alt="NPM Version" /></a>
|
|
17
17
|
<a href="https://www.npmjs.com/package/eslint-plugin-mcp-sdk-security" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-mcp-sdk-security.svg" alt="NPM Downloads" /></a>
|
|
18
|
+
<a href="https://packagephobia.com/result?p=eslint-plugin-mcp-sdk-security" target="_blank"><img src="https://badgen.net/packagephobia/install/eslint-plugin-mcp-sdk-security" alt="Install Size" /></a>
|
|
18
19
|
<a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
|
|
19
20
|
<a href="https://scorecard.dev/viewer/?uri=github.com/ofri-peretz/eslint" target="_blank"><img src="https://api.securityscorecards.dev/projects/github.com/ofri-peretz/eslint/badge" alt="OpenSSF Scorecard" /></a>
|
|
20
21
|
</p>
|
|
@@ -27,57 +28,25 @@ Security rules for code built on [`@modelcontextprotocol/sdk`](https://www.npmjs
|
|
|
27
28
|
|
|
28
29
|
**Scope:** this plugin lints the MCP **SDK's API shapes** — `registerTool`, transports, handler signatures. It does not inspect MCP wire traffic, which isn't visible from source. Every rule gates on the SDK actually being imported, so it stays silent in files that don't use MCP.
|
|
29
30
|
|
|
30
|
-
## Philosophy
|
|
31
|
-
|
|
32
|
-
**Interlace** fosters **strength through integration**. Instead of stacking isolated rules, we **interlace** security directly into your workflow to create a resilient fabric of code. We believe tools should **guide rather than gatekeep**, providing educational feedback that strengthens the developer with every interaction.
|
|
33
|
-
|
|
34
31
|
<!-- AUTO-GENERATED:DOCTRINE:START - Do not edit manually -->
|
|
35
32
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
**
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
That is a trade, and it is made deliberately. It costs recall, and we measure what it
|
|
44
|
-
costs rather than assuming it is free.
|
|
45
|
-
|
|
46
|
-
## How the rules decide
|
|
47
|
-
|
|
48
|
-
**Evidence, not names.** A rule fires on what the code *does*, resolved through the
|
|
49
|
-
AST and ESLint's own scope analysis — not on an identifier that happens to contain
|
|
50
|
-
`query`, a method called `setItem`, or a file whose path contains `key`. Every one of
|
|
51
|
-
those was a real false positive in this ecosystem, found by reading our own output on
|
|
52
|
-
open-source projects and fixed with a test that fails on the unfixed rule.
|
|
53
|
-
|
|
54
|
-
Where a rule has known false-positive shapes, its page carries a **Not a finding**
|
|
55
|
-
section: what it deliberately stays quiet on, and what to check first when it fires
|
|
56
|
-
and you disagree.
|
|
57
|
-
|
|
58
|
-
## What you get
|
|
59
|
-
|
|
60
|
-
The rules below. Security rules carry a CWE mapping and, where one is assigned, a
|
|
61
|
-
CVSS score; every rule carries a fix on its message — in prose for a human and as
|
|
62
|
-
structured JSON for an agent. Install it, enable
|
|
63
|
-
`recommended`, and read the findings. If one of them is wrong,
|
|
64
|
-
[open an issue](https://github.com/ofri-peretz/eslint/issues) — a false positive is a
|
|
65
|
-
bug here, not a tuning exercise for you.
|
|
33
|
+
- **Why** — a linter nobody reads protects nothing. We would rather miss a finding
|
|
34
|
+
than spend your attention on one that was never real.
|
|
35
|
+
- **How** — evidence, not names. A rule fires on what the code *does*, resolved
|
|
36
|
+
through the AST and ESLint's own scope analysis.
|
|
37
|
+
- **What** — every finding carries its fix, in prose for a human and as structured
|
|
38
|
+
JSON for an agent. Security rules add a CWE mapping and, where assigned, a CVSS score.
|
|
66
39
|
|
|
67
|
-
|
|
68
|
-
[
|
|
69
|
-
|
|
40
|
+
That trade costs recall, and we measure it:
|
|
41
|
+
[methodology](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-METHODOLOGY.md)
|
|
42
|
+
· [results](https://github.com/ofri-peretz/eslint/blob/main/BENCHMARK-RESULTS.md)
|
|
43
|
+
· [a false positive is a bug](https://github.com/ofri-peretz/eslint/issues).
|
|
70
44
|
|
|
71
45
|
<!-- AUTO-GENERATED:DOCTRINE:END -->
|
|
72
46
|
|
|
73
47
|
## Getting Started
|
|
74
48
|
|
|
75
49
|
- To check out the [guide](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security), visit [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security). 📚
|
|
76
|
-
- 要查看中文 [指南](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security), 请访问 [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security). 📚
|
|
77
|
-
- [가이드](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security) 문서는 [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security)에서 확인하실 수 있습니다. 📚
|
|
78
|
-
- [ガイド](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security)は [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security)でご確認ください。 📚
|
|
79
|
-
- Para ver la [guía](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security), visita [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security). 📚
|
|
80
|
-
- للاطلاع على [الدليل](https://eslint.interlace.tools/docs/security/plugin-mcp-sdk-security?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security)، قم بزيارة [eslint.interlace.tools](https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security). 📚
|
|
81
50
|
|
|
82
51
|
```bash
|
|
83
52
|
npm install eslint-plugin-mcp-sdk-security --save-dev
|
|
@@ -167,19 +136,52 @@ If this plugin caught a real bug for you, **[star the repo](https://github.com/o
|
|
|
167
136
|
|
|
168
137
|
<!-- INTERLACE:STAR_CTA:END -->
|
|
169
138
|
|
|
139
|
+
<!-- AUTO-GENERATED:ECOSYSTEM_TABLE:START - Do not edit manually -->
|
|
140
|
+
|
|
170
141
|
## 🔗 Related ESLint Plugins
|
|
171
142
|
|
|
172
|
-
Part of the **Interlace ESLint
|
|
143
|
+
Part of the **Interlace ESLint ecosystem** — AI-native rules with LLM-optimized error messages:
|
|
144
|
+
|
|
145
|
+
**Security**
|
|
173
146
|
|
|
174
147
|
| Plugin | Downloads | Description |
|
|
175
148
|
| :--- | :---: | :--- |
|
|
176
|
-
| [`eslint-plugin-
|
|
177
|
-
| [`eslint-plugin-
|
|
178
|
-
| [`eslint-plugin-
|
|
149
|
+
| [`eslint-plugin-anthropic-security`](https://www.npmjs.com/package/eslint-plugin-anthropic-security) | [](https://www.npmjs.com/package/eslint-plugin-anthropic-security) | Anthropic SDK security. |
|
|
150
|
+
| [`eslint-plugin-browser-security`](https://www.npmjs.com/package/eslint-plugin-browser-security) | [](https://www.npmjs.com/package/eslint-plugin-browser-security) | XSS, DOM security. |
|
|
151
|
+
| [`eslint-plugin-drizzle-security`](https://www.npmjs.com/package/eslint-plugin-drizzle-security) | [](https://www.npmjs.com/package/eslint-plugin-drizzle-security) | Drizzle security. |
|
|
152
|
+
| [`eslint-plugin-express-security`](https://www.npmjs.com/package/eslint-plugin-express-security) | [](https://www.npmjs.com/package/eslint-plugin-express-security) | Express middleware hardening. |
|
|
179
153
|
| [`eslint-plugin-gemini-security`](https://www.npmjs.com/package/eslint-plugin-gemini-security) | [](https://www.npmjs.com/package/eslint-plugin-gemini-security) | Google Gemini SDK security. |
|
|
180
|
-
| [`eslint-plugin-
|
|
181
|
-
| [`eslint-plugin-
|
|
182
|
-
| [`eslint-plugin-
|
|
154
|
+
| [`eslint-plugin-jwt-security`](https://www.npmjs.com/package/eslint-plugin-jwt-security) | [](https://www.npmjs.com/package/eslint-plugin-jwt-security) | Token security. |
|
|
155
|
+
| [`eslint-plugin-knex-security`](https://www.npmjs.com/package/eslint-plugin-knex-security) | [](https://www.npmjs.com/package/eslint-plugin-knex-security) | Knex security. |
|
|
156
|
+
| [`eslint-plugin-lambda-security`](https://www.npmjs.com/package/eslint-plugin-lambda-security) | [](https://www.npmjs.com/package/eslint-plugin-lambda-security) | AWS Lambda hardening. |
|
|
157
|
+
| [`eslint-plugin-mongodb-security`](https://www.npmjs.com/package/eslint-plugin-mongodb-security) | [](https://www.npmjs.com/package/eslint-plugin-mongodb-security) | MongoDB injection. |
|
|
158
|
+
| [`eslint-plugin-mysql-security`](https://www.npmjs.com/package/eslint-plugin-mysql-security) | [](https://www.npmjs.com/package/eslint-plugin-mysql-security) | MySQL security. |
|
|
159
|
+
| [`eslint-plugin-nestjs-security`](https://www.npmjs.com/package/eslint-plugin-nestjs-security) | [](https://www.npmjs.com/package/eslint-plugin-nestjs-security) | NestJS framework hardening. |
|
|
160
|
+
| [`eslint-plugin-node-security`](https://www.npmjs.com/package/eslint-plugin-node-security) | [](https://www.npmjs.com/package/eslint-plugin-node-security) | Server-side patterns. |
|
|
161
|
+
| [`eslint-plugin-openai-security`](https://www.npmjs.com/package/eslint-plugin-openai-security) | [](https://www.npmjs.com/package/eslint-plugin-openai-security) | OpenAI SDK security. |
|
|
162
|
+
| [`eslint-plugin-postgresql-security`](https://www.npmjs.com/package/eslint-plugin-postgresql-security) | [](https://www.npmjs.com/package/eslint-plugin-postgresql-security) | PostgreSQL security. |
|
|
163
|
+
| [`eslint-plugin-prisma-security`](https://www.npmjs.com/package/eslint-plugin-prisma-security) | [](https://www.npmjs.com/package/eslint-plugin-prisma-security) | Prisma security. |
|
|
164
|
+
| [`eslint-plugin-secure-coding`](https://www.npmjs.com/package/eslint-plugin-secure-coding) | [](https://www.npmjs.com/package/eslint-plugin-secure-coding) | Injection prevention. |
|
|
165
|
+
| [`eslint-plugin-sequelize-security`](https://www.npmjs.com/package/eslint-plugin-sequelize-security) | [](https://www.npmjs.com/package/eslint-plugin-sequelize-security) | Sequelize ORM security. |
|
|
166
|
+
| [`eslint-plugin-sqlite-security`](https://www.npmjs.com/package/eslint-plugin-sqlite-security) | [](https://www.npmjs.com/package/eslint-plugin-sqlite-security) | SQLite security. |
|
|
167
|
+
| [`eslint-plugin-typeorm-security`](https://www.npmjs.com/package/eslint-plugin-typeorm-security) | [](https://www.npmjs.com/package/eslint-plugin-typeorm-security) | TypeORM security. |
|
|
168
|
+
| [`eslint-plugin-vercel-ai-security`](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | [](https://www.npmjs.com/package/eslint-plugin-vercel-ai-security) | AI SDK security. |
|
|
169
|
+
|
|
170
|
+
**Code quality**
|
|
171
|
+
|
|
172
|
+
| Plugin | Downloads | Description |
|
|
173
|
+
| :--- | :---: | :--- |
|
|
174
|
+
| [`eslint-plugin-conventions`](https://www.npmjs.com/package/eslint-plugin-conventions) | [](https://www.npmjs.com/package/eslint-plugin-conventions) | Team-specific habits and styles. |
|
|
175
|
+
| [`eslint-plugin-import-next`](https://www.npmjs.com/package/eslint-plugin-import-next) | [](https://www.npmjs.com/package/eslint-plugin-import-next) | Fast cycle + import-graph analysis. |
|
|
176
|
+
| [`eslint-plugin-maintainability`](https://www.npmjs.com/package/eslint-plugin-maintainability) | [](https://www.npmjs.com/package/eslint-plugin-maintainability) | Cognitive load and clean-code patterns. |
|
|
177
|
+
| [`eslint-plugin-modernization`](https://www.npmjs.com/package/eslint-plugin-modernization) | [](https://www.npmjs.com/package/eslint-plugin-modernization) | ESNext migration + syntax evolution. |
|
|
178
|
+
| [`eslint-plugin-modularity`](https://www.npmjs.com/package/eslint-plugin-modularity) | [](https://www.npmjs.com/package/eslint-plugin-modularity) | Structural integrity and DDD patterns. |
|
|
179
|
+
| [`eslint-plugin-operability`](https://www.npmjs.com/package/eslint-plugin-operability) | [](https://www.npmjs.com/package/eslint-plugin-operability) | Production readiness and resource health. |
|
|
180
|
+
| [`eslint-plugin-react-a11y`](https://www.npmjs.com/package/eslint-plugin-react-a11y) | [](https://www.npmjs.com/package/eslint-plugin-react-a11y) | React accessibility / WCAG. |
|
|
181
|
+
| [`eslint-plugin-react-features`](https://www.npmjs.com/package/eslint-plugin-react-features) | [](https://www.npmjs.com/package/eslint-plugin-react-features) | React best practices and optimization. |
|
|
182
|
+
| [`eslint-plugin-reliability`](https://www.npmjs.com/package/eslint-plugin-reliability) | [](https://www.npmjs.com/package/eslint-plugin-reliability) | Runtime stability and error safety. |
|
|
183
|
+
|
|
184
|
+
<!-- AUTO-GENERATED:ECOSYSTEM_TABLE:END -->
|
|
183
185
|
|
|
184
186
|
## 📄 License
|
|
185
187
|
|
|
@@ -190,5 +192,5 @@ MIT © [Ofri Peretz](https://github.com/ofri-peretz)
|
|
|
190
192
|
</p>
|
|
191
193
|
|
|
192
194
|
<p align="center">
|
|
193
|
-
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security" target="blank"><img src="https://eslint.interlace.tools/
|
|
195
|
+
<a href="https://eslint.interlace.tools/?utm_source=github&utm_medium=referral&utm_campaign=eslint-plugin-mcp-sdk-security" target="blank"><picture><source media="(prefers-color-scheme: dark)" srcset="https://eslint.interlace.tools/logos/interlace-dark.svg"><img src="https://eslint.interlace.tools/logos/interlace-light.svg" alt="Interlace" height="70" /></picture></a>
|
|
194
196
|
</p>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "eslint-plugin-mcp-sdk-security",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "ESLint plugin for Model Context Protocol (MCP) SDK security — catches tools registered without an input schema, handlers reading arguments the schema never declared, model-visible descriptions built from dynamic text, and tool arguments reaching a shell.",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"main": "./src/index.js",
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
}
|
|
75
75
|
},
|
|
76
76
|
"dependencies": {
|
|
77
|
-
"@interlace/eslint-devkit": "^1.
|
|
77
|
+
"@interlace/eslint-devkit": "^1.18.2"
|
|
78
78
|
},
|
|
79
79
|
"funding": {
|
|
80
80
|
"type": "github",
|
package/src/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=exports.requireToolInputSchema=exports.noUnvalidatedToolArgs=exports.noToolDescriptionInjection=exports.noCommandInjectionInTool=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");var no_command_injection_in_tool_2=require("./rules/no-command-injection-in-tool");Object.defineProperty(exports,"noCommandInjectionInTool",{enumerable:true,get:function(){return no_command_injection_in_tool_2.noCommandInjectionInTool}});var no_tool_description_injection_2=require("./rules/no-tool-description-injection");Object.defineProperty(exports,"noToolDescriptionInjection",{enumerable:true,get:function(){return no_tool_description_injection_2.noToolDescriptionInjection}});var no_unvalidated_tool_args_2=require("./rules/no-unvalidated-tool-args");Object.defineProperty(exports,"noUnvalidatedToolArgs",{enumerable:true,get:function(){return no_unvalidated_tool_args_2.noUnvalidatedToolArgs}});var require_tool_input_schema_2=require("./rules/require-tool-input-schema");Object.defineProperty(exports,"requireToolInputSchema",{enumerable:true,get:function(){return require_tool_input_schema_2.requireToolInputSchema}});exports.rules={get"no-command-injection-in-tool"(){return require("./rules/no-command-injection-in-tool").noCommandInjectionInTool},get"no-tool-description-injection"(){return require("./rules/no-tool-description-injection").noToolDescriptionInjection},get"no-unvalidated-tool-args"(){return require("./rules/no-unvalidated-tool-args").noUnvalidatedToolArgs},get"require-tool-input-schema"(){return require("./rules/require-tool-input-schema").requireToolInputSchema}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-mcp-sdk-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-mcp-sdk-security",version:"0.
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=exports.requireToolInputSchema=exports.noUnvalidatedToolArgs=exports.noToolDescriptionInjection=exports.noCommandInjectionInTool=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");var no_command_injection_in_tool_2=require("./rules/no-command-injection-in-tool");Object.defineProperty(exports,"noCommandInjectionInTool",{enumerable:true,get:function(){return no_command_injection_in_tool_2.noCommandInjectionInTool}});var no_tool_description_injection_2=require("./rules/no-tool-description-injection");Object.defineProperty(exports,"noToolDescriptionInjection",{enumerable:true,get:function(){return no_tool_description_injection_2.noToolDescriptionInjection}});var no_unvalidated_tool_args_2=require("./rules/no-unvalidated-tool-args");Object.defineProperty(exports,"noUnvalidatedToolArgs",{enumerable:true,get:function(){return no_unvalidated_tool_args_2.noUnvalidatedToolArgs}});var require_tool_input_schema_2=require("./rules/require-tool-input-schema");Object.defineProperty(exports,"requireToolInputSchema",{enumerable:true,get:function(){return require_tool_input_schema_2.requireToolInputSchema}});exports.rules={get"no-command-injection-in-tool"(){return require("./rules/no-command-injection-in-tool").noCommandInjectionInTool},get"no-tool-description-injection"(){return require("./rules/no-tool-description-injection").noToolDescriptionInjection},get"no-unvalidated-tool-args"(){return require("./rules/no-unvalidated-tool-args").noUnvalidatedToolArgs},get"require-tool-input-schema"(){return require("./rules/require-tool-input-schema").requireToolInputSchema}};(0,eslint_devkit_1.withCanonicalDocsUrls)("plugin-mcp-sdk-security",exports.rules);exports.plugin={meta:{name:"eslint-plugin-mcp-sdk-security",version:"0.4.1"},rules:exports.rules};const minimalConfig={plugins:{"mcp-sdk-security":exports.plugin},rules:{"mcp-sdk-security/require-tool-input-schema":"error"}};const recommendedConfig={plugins:{"mcp-sdk-security":exports.plugin},rules:{"mcp-sdk-security/require-tool-input-schema":"error"}};const strictConfig={plugins:{"mcp-sdk-security":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`mcp-sdk-security/${ruleName}`,"error"]))};exports.configs={minimal:minimalConfig,recommended:recommendedConfig,strict:strictConfig};exports.default={...exports.plugin,configs:exports.configs};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noToolDescriptionInjection=void 0;exports.isStaticText=isStaticText;exports.modelFacingProperties=modelFacingProperties;const eslint_devkit_1=require("@interlace/eslint-devkit");const mcp_evidence_1=require("../../utils/mcp-evidence");const REGISTER_TOOL="registerTool";const LEGACY_TOOL="tool";const MODEL_FACING_KEYS=["description","title"];function isStaticText(node){if(node.type==="Literal")return typeof node.value==="string";if(node.type==="TemplateLiteral")return node.expressions.length===0;if(node.type==="BinaryExpression"&&node.operator==="+"){return isStaticText(node.left)&&isStaticText(node.right)}return false}function modelFacingProperties(config){const found=[];for(const prop of config.properties){if(prop.type!=="Property"||prop.computed)continue;const key=prop.key.type==="Identifier"?prop.key.name:
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noToolDescriptionInjection=void 0;exports.isStaticText=isStaticText;exports.modelFacingProperties=modelFacingProperties;const eslint_devkit_1=require("@interlace/eslint-devkit");const mcp_evidence_1=require("../../utils/mcp-evidence");const REGISTER_TOOL="registerTool";const LEGACY_TOOL="tool";const MODEL_FACING_KEYS=["description","title"];function isStaticText(node){if(node.type==="Literal")return typeof node.value==="string";if(node.type==="TemplateLiteral")return node.expressions.length===0;if(node.type==="BinaryExpression"&&node.operator==="+"){return isStaticText(node.left)&&isStaticText(node.right)}return false}function modelFacingProperties(config){const found=[];for(const prop of config.properties){if(prop.type!=="Property"||prop.computed)continue;const key=prop.key.type==="Identifier"?prop.key.name:(0,eslint_devkit_1.staticString)(prop.key)??void 0;if(key===void 0)continue;if(!MODEL_FACING_KEYS.includes(key))continue;if(isStaticText(prop.value))continue;found.push({key,value:prop.value})}return found}exports.noToolDescriptionInjection=(0,eslint_devkit_1.createRule)({name:"no-tool-description-injection",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-mcp-sdk-security/docs/rules/no-tool-description-injection.md",description:"Require MCP tool descriptions and titles to be static text, since they reach the model as instructions",cwe:"CWE-1427",cvss:8.6},messages:{dynamicDescription:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"MCP Tool Description Built at Runtime",cwe:"CWE-1427",owasp:"A03:2021",cvss:8.6,description:'The `{{key}}` for tool "{{tool}}" is assembled at runtime, so it reaches the model as instruction text this file does not control',severity:"HIGH",compliance:["SOC2"],fix:"Write the {{key}} as a literal. If it genuinely varies, register a separate tool per variant rather than interpolating \u2014 the text lands in the model's instruction block, so whoever controls the value controls the instructions.",documentationLink:"https://modelcontextprotocol.io/docs/concepts/tools"})},schema:[]},defaultOptions:[],create(context){if(!(0,mcp_evidence_1.fileUsesMcpSdk)(context.sourceCode.ast))return{};const candidates=[];function toolNameOf(node){const first=node.arguments[0];if(first?.type==="Literal"&&typeof first.value==="string")return first.value;return"unknown"}return{CallExpression(node){if(node.callee.type!=="MemberExpression"||node.callee.computed)return;if(node.callee.property.type!=="Identifier")return;const method=node.callee.property.name;if(method!==REGISTER_TOOL&&method!==LEGACY_TOOL)return;const config=node.arguments[1];if(config?.type!=="ObjectExpression")return;for(const finding of modelFacingProperties(config)){candidates.push({node:finding.value,tool:toolNameOf(node),key:finding.key})}},"Program:exit"(){for(const{node,tool,key}of candidates){context.report({node,messageId:"dynamicDescription",data:{tool,key}})}}}}});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noUnvalidatedToolArgs=void 0;exports.propertyKey=propertyKey;exports.declaredSchemaKeys=declaredSchemaKeys;exports.destructuredArgNames=destructuredArgNames;const eslint_devkit_1=require("@interlace/eslint-devkit");const mcp_evidence_1=require("../../utils/mcp-evidence");const REGISTER_TOOL="registerTool";const LEGACY_TOOL="tool";function propertyKey(prop){if(prop.type!=="Property"||prop.computed)return void 0;if(prop.key.type==="Identifier")return prop.key.name;
|
|
1
|
+
"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noUnvalidatedToolArgs=void 0;exports.propertyKey=propertyKey;exports.declaredSchemaKeys=declaredSchemaKeys;exports.destructuredArgNames=destructuredArgNames;const eslint_devkit_1=require("@interlace/eslint-devkit");const mcp_evidence_1=require("../../utils/mcp-evidence");const REGISTER_TOOL="registerTool";const LEGACY_TOOL="tool";function propertyKey(prop){if(prop.type!=="Property"||prop.computed)return void 0;if(prop.key.type==="Identifier")return prop.key.name;return(0,eslint_devkit_1.staticString)(prop.key)??void 0}function declaredSchemaKeys(config){const index=config.properties.findIndex(prop=>propertyKey(prop)==="inputSchema");if(index===-1)return void 0;for(let i=index+1;i<config.properties.length;i++){if(config.properties[i].type==="SpreadElement")return void 0}const value=config.properties[index].value;if(value.type!=="ObjectExpression")return void 0;const keys=new Set;for(const entry of value.properties){if(entry.type==="SpreadElement")return void 0;const key=propertyKey(entry);if(key===void 0)return void 0;keys.add(key)}return keys}function destructuredArgNames(handler){if(handler.type!=="ArrowFunctionExpression"&&handler.type!=="FunctionExpression"&&handler.type!=="FunctionDeclaration"){return[]}const first=handler.params[0];if(first===void 0||first.type!=="ObjectPattern")return[];const found=[];for(const prop of first.properties){if(prop.type==="RestElement")continue;const key=propertyKey(prop);if(key===void 0)continue;found.push({name:key,node:prop})}return found}exports.noUnvalidatedToolArgs=(0,eslint_devkit_1.createRule)({name:"no-unvalidated-tool-args",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-mcp-sdk-security/docs/rules/no-unvalidated-tool-args.md",description:"Disallow a tool handler reading an argument its declared input schema does not include",cwe:"CWE-20",cvss:7.5},messages:{undeclaredArg:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.SECURITY,issueName:"MCP Tool Argument Outside the Declared Schema",cwe:"CWE-20",owasp:"A03:2021",cvss:7.5,description:'Tool "{{tool}}" reads `{{arg}}`, which its inputSchema does not declare \u2014 so the value either arrives unvalidated or never arrives at all',severity:"HIGH",compliance:["SOC2"],fix:"Declare `{{arg}}` in the inputSchema with the type and constraints it needs, or stop reading it. A key the schema does not mention is one nothing validated.",documentationLink:"https://modelcontextprotocol.io/docs/concepts/tools"})},schema:[]},defaultOptions:[],create(context){if(!(0,mcp_evidence_1.fileUsesMcpSdk)(context.sourceCode.ast))return{};const candidates=[];function toolNameOf(node){const first=node.arguments[0];if(first?.type==="Literal"&&typeof first.value==="string")return first.value;return"unknown"}return{CallExpression(node){if(node.callee.type!=="MemberExpression"||node.callee.computed)return;if(node.callee.property.type!=="Identifier")return;const method=node.callee.property.name;if(method!==REGISTER_TOOL&&method!==LEGACY_TOOL)return;const config=node.arguments[1];if(config?.type!=="ObjectExpression")return;const declared=declaredSchemaKeys(config);if(declared===void 0)return;const handler=node.arguments[node.arguments.length-1];for(const read of destructuredArgNames(handler)){if(declared.has(read.name))continue;candidates.push({node:read.node,tool:toolNameOf(node),arg:read.name})}},"Program:exit"(){for(const{node,tool,arg}of candidates){context.report({node,messageId:"undeclaredArg",data:{tool,arg}})}}}}});
|