circle-ir-ai 4.16.4 → 4.17.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 (75) hide show
  1. package/CHANGELOG.md +86 -41
  2. package/README.md +20 -0
  3. package/dist/mcp/analysis.d.ts +25 -0
  4. package/dist/mcp/analysis.d.ts.map +1 -0
  5. package/dist/mcp/analysis.js +45 -0
  6. package/dist/mcp/analysis.js.map +1 -0
  7. package/dist/mcp/index.d.ts +24 -0
  8. package/dist/mcp/index.d.ts.map +1 -0
  9. package/dist/mcp/index.js +67 -0
  10. package/dist/mcp/index.js.map +1 -0
  11. package/dist/mcp/mappers.d.ts +41 -0
  12. package/dist/mcp/mappers.d.ts.map +1 -0
  13. package/dist/mcp/mappers.js +69 -0
  14. package/dist/mcp/mappers.js.map +1 -0
  15. package/dist/mcp/result.d.ts +32 -0
  16. package/dist/mcp/result.d.ts.map +1 -0
  17. package/dist/mcp/result.js +35 -0
  18. package/dist/mcp/result.js.map +1 -0
  19. package/dist/mcp/tools/check-license-compliance.d.ts +11 -0
  20. package/dist/mcp/tools/check-license-compliance.d.ts.map +1 -0
  21. package/dist/mcp/tools/check-license-compliance.js +124 -0
  22. package/dist/mcp/tools/check-license-compliance.js.map +1 -0
  23. package/dist/mcp/tools/find-credential-exposure.d.ts +20 -0
  24. package/dist/mcp/tools/find-credential-exposure.d.ts.map +1 -0
  25. package/dist/mcp/tools/find-credential-exposure.js +205 -0
  26. package/dist/mcp/tools/find-credential-exposure.js.map +1 -0
  27. package/dist/mcp/tools/find-excessive-permissions.d.ts +16 -0
  28. package/dist/mcp/tools/find-excessive-permissions.d.ts.map +1 -0
  29. package/dist/mcp/tools/find-excessive-permissions.js +143 -0
  30. package/dist/mcp/tools/find-excessive-permissions.js.map +1 -0
  31. package/dist/mcp/tools/find-install-script-risk.d.ts +11 -0
  32. package/dist/mcp/tools/find-install-script-risk.d.ts.map +1 -0
  33. package/dist/mcp/tools/find-install-script-risk.js +114 -0
  34. package/dist/mcp/tools/find-install-script-risk.js.map +1 -0
  35. package/dist/mcp/tools/find-pattern.d.ts +13 -0
  36. package/dist/mcp/tools/find-pattern.d.ts.map +1 -0
  37. package/dist/mcp/tools/find-pattern.js +113 -0
  38. package/dist/mcp/tools/find-pattern.js.map +1 -0
  39. package/dist/mcp/tools/find-spec-drift.d.ts +10 -0
  40. package/dist/mcp/tools/find-spec-drift.d.ts.map +1 -0
  41. package/dist/mcp/tools/find-spec-drift.js +40 -0
  42. package/dist/mcp/tools/find-spec-drift.js.map +1 -0
  43. package/dist/mcp/tools/find-stale-dependencies.d.ts +14 -0
  44. package/dist/mcp/tools/find-stale-dependencies.d.ts.map +1 -0
  45. package/dist/mcp/tools/find-stale-dependencies.js +176 -0
  46. package/dist/mcp/tools/find-stale-dependencies.js.map +1 -0
  47. package/dist/mcp/tools/find-typosquats.d.ts +11 -0
  48. package/dist/mcp/tools/find-typosquats.d.ts.map +1 -0
  49. package/dist/mcp/tools/find-typosquats.js +140 -0
  50. package/dist/mcp/tools/find-typosquats.js.map +1 -0
  51. package/dist/mcp/tools/layer-bom.d.ts +15 -0
  52. package/dist/mcp/tools/layer-bom.d.ts.map +1 -0
  53. package/dist/mcp/tools/layer-bom.js +97 -0
  54. package/dist/mcp/tools/layer-bom.js.map +1 -0
  55. package/dist/mcp/tools/verify-spec-conformance.d.ts +9 -0
  56. package/dist/mcp/tools/verify-spec-conformance.d.ts.map +1 -0
  57. package/dist/mcp/tools/verify-spec-conformance.js +46 -0
  58. package/dist/mcp/tools/verify-spec-conformance.js.map +1 -0
  59. package/dist/mcp/types.d.ts +36 -0
  60. package/dist/mcp/types.d.ts.map +1 -0
  61. package/dist/mcp/types.js +17 -0
  62. package/dist/mcp/types.js.map +1 -0
  63. package/dist/mcp/walk.d.ts +33 -0
  64. package/dist/mcp/walk.d.ts.map +1 -0
  65. package/dist/mcp/walk.js +83 -0
  66. package/dist/mcp/walk.js.map +1 -0
  67. package/dist/secret-scan/scanner.d.ts +7 -0
  68. package/dist/secret-scan/scanner.d.ts.map +1 -1
  69. package/dist/secret-scan/scanner.js +1 -1
  70. package/dist/secret-scan/scanner.js.map +1 -1
  71. package/package.json +18 -3
  72. package/dist/coverage/index.d.ts +0 -50
  73. package/dist/coverage/index.d.ts.map +0 -1
  74. package/dist/coverage/index.js +0 -73
  75. package/dist/coverage/index.js.map +0 -1
@@ -0,0 +1,124 @@
1
+ /**
2
+ * check_license_compliance MCP tool (Pillar I, Workflow #2).
3
+ *
4
+ * Scans a code root for copyleft/restrictive license issues in dependencies.
5
+ * Supports Node.js (package.json) and Rust (Cargo.toml) ecosystems.
6
+ *
7
+ * @see https://github.com/cogniumhq/cognium-ai/issues/79
8
+ */
9
+ import { z } from 'zod';
10
+ import { DETERMINISTIC, provenanceSchema, toolResult } from '../result.js';
11
+ import { scanLicenseCompliance, COPYLEFT_SEVERITY, } from '../../trust/index.js';
12
+ const MAX_FINDINGS = 500;
13
+ const inputSchema = {
14
+ code_root: z.string().describe('Absolute path to the code root to scan'),
15
+ include_dev_deps: z.boolean().optional().default(false).describe('Include devDependencies (default: false)'),
16
+ severity_floor: z.enum(['info', 'low', 'medium', 'high', 'critical']).optional().default('low').describe('Minimum severity to report (default: low)'),
17
+ };
18
+ const findingSchema = z.object({
19
+ kind: z.literal('LICENSE_VIOLATION'),
20
+ severity: z.enum(['low', 'medium', 'high', 'critical']),
21
+ location: z.object({
22
+ file: z.string(),
23
+ span: z.tuple([z.number(), z.number()]),
24
+ }),
25
+ evidence: z.object({
26
+ rule_id: z.string(),
27
+ dependency: z.string(),
28
+ license: z.string(),
29
+ confidence: z.number(),
30
+ }),
31
+ suggested_action: z.string(),
32
+ });
33
+ const outputSchema = {
34
+ findings: z.array(findingSchema),
35
+ summary: z.object({
36
+ total: z.number(),
37
+ by_severity: z.object({
38
+ critical: z.number(),
39
+ high: z.number(),
40
+ medium: z.number(),
41
+ low: z.number(),
42
+ }),
43
+ by_ecosystem: z.object({
44
+ nodejs: z.number(),
45
+ rust: z.number(),
46
+ }),
47
+ truncated: z.boolean(),
48
+ }),
49
+ copyleft_reference: z.record(z.string(), z.string()).describe('Reference table: license to severity'),
50
+ provenance: provenanceSchema,
51
+ };
52
+ const SEVERITY_ORDER = {
53
+ info: 0,
54
+ low: 1,
55
+ medium: 2,
56
+ high: 3,
57
+ critical: 4,
58
+ };
59
+ function licenseToFinding(finding) {
60
+ return {
61
+ kind: 'LICENSE_VIOLATION',
62
+ severity: finding.severity === 'info' ? 'low' : finding.severity,
63
+ location: {
64
+ file: finding.file,
65
+ span: [finding.line ?? 1, finding.line ?? 1],
66
+ },
67
+ evidence: {
68
+ rule_id: finding.ruleId,
69
+ dependency: finding.dependency,
70
+ license: finding.license,
71
+ confidence: finding.confidence,
72
+ },
73
+ suggested_action: finding.suggestedAction,
74
+ };
75
+ }
76
+ function buildCopyleftReference() {
77
+ const ref = {};
78
+ for (const [license, severity] of Object.entries(COPYLEFT_SEVERITY)) {
79
+ ref[license] = severity;
80
+ }
81
+ return ref;
82
+ }
83
+ export function registerCheckLicenseCompliance(server) {
84
+ server.registerTool('check_license_compliance', {
85
+ title: 'Check License Compliance',
86
+ description: 'Scan a code root for copyleft/restrictive license issues in dependencies. ' +
87
+ 'Supports Node.js (package.json) and Rust (Cargo.toml). ' +
88
+ 'Flags AGPL, GPL, LGPL, MPL, and other copyleft licenses with severity classification. ' +
89
+ 'Returns findings with dependency info, license SPDX, and remediation guidance.',
90
+ inputSchema,
91
+ outputSchema,
92
+ }, async ({ code_root, include_dev_deps, severity_floor }) => {
93
+ const scanResult = await scanLicenseCompliance(code_root, {
94
+ includeDevDeps: include_dev_deps,
95
+ minSeverity: severity_floor,
96
+ });
97
+ const floorValue = SEVERITY_ORDER[severity_floor ?? 'low'];
98
+ const filteredFindings = scanResult.findings.filter((f) => SEVERITY_ORDER[f.severity] >= floorValue);
99
+ const truncated = filteredFindings.length > MAX_FINDINGS;
100
+ const findings = filteredFindings
101
+ .slice(0, MAX_FINDINGS)
102
+ .map(licenseToFinding);
103
+ const result = {
104
+ findings,
105
+ summary: {
106
+ total: filteredFindings.length,
107
+ by_severity: {
108
+ critical: filteredFindings.filter((f) => f.severity === 'critical').length,
109
+ high: filteredFindings.filter((f) => f.severity === 'high').length,
110
+ medium: filteredFindings.filter((f) => f.severity === 'medium').length,
111
+ low: filteredFindings.filter((f) => f.severity === 'low').length,
112
+ },
113
+ by_ecosystem: {
114
+ nodejs: filteredFindings.filter((f) => f.ecosystem === 'nodejs').length,
115
+ rust: filteredFindings.filter((f) => f.ecosystem === 'rust').length,
116
+ },
117
+ truncated,
118
+ },
119
+ copyleft_reference: buildCopyleftReference(),
120
+ };
121
+ return toolResult(result, DETERMINISTIC);
122
+ });
123
+ }
124
+ //# sourceMappingURL=check-license-compliance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check-license-compliance.js","sourceRoot":"","sources":["../../../src/mcp/tools/check-license-compliance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * `find_credential_exposure` MCP tool (Pillar I, Workflow #1).
3
+ *
4
+ * Scans a code root for hardcoded credentials (API keys, tokens, passwords,
5
+ * private keys) using circle-ir's ScanSecretsPass for SAST detection and
6
+ * circle-ir-ai's secret scanner for git history scanning.
7
+ *
8
+ * Architecture:
9
+ * - SAST detection: Delegated to circle-ir's ScanSecretsPass (no duplication)
10
+ * - Git history: circle-ir-ai scans commits (cross-commit analysis)
11
+ * - Output: Common Pillar I findings envelope for cognium-code integration
12
+ *
13
+ * @see https://github.com/cogniumhq/cognium-ai/issues/78
14
+ */
15
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
16
+ import { type ModuleContext } from '../types.js';
17
+ /** The one line a caller gets when `llm_verify` is asked for and not enabled. */
18
+ export declare const LLM_VERIFY_REFUSAL: string;
19
+ export declare function registerFindCredentialExposure(server: McpServer, ctx: ModuleContext): void;
20
+ //# sourceMappingURL=find-credential-exposure.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-credential-exposure.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/find-credential-exposure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAgK7D,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,QAE4D,CAAC;AAE5F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAiF1F"}
@@ -0,0 +1,205 @@
1
+ /**
2
+ * `find_credential_exposure` MCP tool (Pillar I, Workflow #1).
3
+ *
4
+ * Scans a code root for hardcoded credentials (API keys, tokens, passwords,
5
+ * private keys) using circle-ir's ScanSecretsPass for SAST detection and
6
+ * circle-ir-ai's secret scanner for git history scanning.
7
+ *
8
+ * Architecture:
9
+ * - SAST detection: Delegated to circle-ir's ScanSecretsPass (no duplication)
10
+ * - Git history: circle-ir-ai scans commits (cross-commit analysis)
11
+ * - Output: Common Pillar I findings envelope for cognium-code integration
12
+ *
13
+ * @see https://github.com/cogniumhq/cognium-ai/issues/78
14
+ */
15
+ import { z } from 'zod';
16
+ import { DETERMINISTIC, llmProvenance, provenanceSchema, refusal, toolResult } from '../result.js';
17
+ import { llmEnabled } from '../types.js';
18
+ import { getDefaultLLMConfig } from '../../llm/config.js';
19
+ import { scanForSecrets } from '../../secret-scan/index.js';
20
+ /** Hard cap on findings returned. */
21
+ const MAX_FINDINGS = 500;
22
+ const inputSchema = {
23
+ code_root: z.string().describe('Absolute path to the code root to scan'),
24
+ include_git_history: z.boolean().optional().default(false).describe('Scan git history for secrets (default: false)'),
25
+ severity_floor: z.enum(['info', 'low', 'medium', 'high', 'critical']).optional().default('low').describe('Minimum severity to report (default: low)'),
26
+ // REFACTOR-019 (since 0.4.18): expose LLM verify controls. Default
27
+ // OFF for the MCP surface — clients invoking via MCP may not have
28
+ // LLM_API_KEY available, and an opt-in surface is friendlier than
29
+ // a silent ON. cognium-ai 2.14.x defaults the CLI to ON because
30
+ // users opt into the CLI; MCP clients haven't.
31
+ llm_verify: z.boolean().optional().default(false).describe('LLM-backed: ask a model to re-check candidates and drop false positives (default: false). Needs a configured endpoint or a licence token; the call is refused without one'),
32
+ verify_budget: z.number().int().min(0).optional().default(100).describe('Cap on LLM verifier calls per scan (default: 100; 0 disables LLM verify entirely)'),
33
+ };
34
+ const findingSchema = z.object({
35
+ kind: z.literal('CREDENTIAL_EXPOSURE'),
36
+ severity: z.enum(['low', 'medium', 'high', 'critical']),
37
+ location: z.object({
38
+ file: z.string(),
39
+ span: z.tuple([z.number(), z.number()]),
40
+ }),
41
+ evidence: z.object({
42
+ rule_id: z.string(),
43
+ match_snippet: z.string(),
44
+ confidence: z.number(),
45
+ }),
46
+ suggested_action: z.string(),
47
+ });
48
+ const outputSchema = {
49
+ findings: z.array(findingSchema),
50
+ summary: z.object({
51
+ total: z.number(),
52
+ by_severity: z.object({
53
+ critical: z.number(),
54
+ high: z.number(),
55
+ medium: z.number(),
56
+ low: z.number(),
57
+ }),
58
+ truncated: z.boolean(),
59
+ }),
60
+ provenance: provenanceSchema,
61
+ };
62
+ /**
63
+ * Map severity to suggested action
64
+ */
65
+ function getSuggestedAction(secret) {
66
+ const category = secret.category.toLowerCase();
67
+ const isActive = secret.presentInHead;
68
+ if (!isActive) {
69
+ return 'Secret found in git history only. Consider rotating and cleaning history with git-filter-repo or BFG.';
70
+ }
71
+ switch (category) {
72
+ case 'aws':
73
+ return 'Rotate the AWS access key immediately via IAM console and move to AWS Secrets Manager or environment variables.';
74
+ case 'github':
75
+ return 'Revoke the token at https://github.com/settings/tokens and use GITHUB_TOKEN or repository secrets instead.';
76
+ case 'openai':
77
+ return 'Revoke the key at https://platform.openai.com/api-keys and load from environment variables.';
78
+ case 'anthropic':
79
+ return 'Revoke the key in the Anthropic Console and load from environment variables.';
80
+ case 'stripe':
81
+ return 'Rotate in the Stripe Dashboard and use environment variables or a secrets manager.';
82
+ case 'slack':
83
+ return 'Revoke the token in Slack workspace settings and use environment variables.';
84
+ case 'gcp':
85
+ return 'Restrict or revoke in Google Cloud Console and use service account keys or Workload Identity.';
86
+ case 'private-key':
87
+ return 'Remove immediately, rotate the keypair, and never commit private keys to source control.';
88
+ case 'jwt':
89
+ return 'JWTs carry whatever scope they were minted with. Rotate signing keys and remove the token.';
90
+ case 'npm':
91
+ return 'Revoke at https://www.npmjs.com/settings/<user>/tokens and use NPM_TOKEN environment variable.';
92
+ case 'high-entropy':
93
+ return 'If this is a credential, move to environment variables or a secrets manager. If sample data, add to .gitignore.';
94
+ default:
95
+ return 'Rotate this credential immediately and move to environment variables or a secrets manager.';
96
+ }
97
+ }
98
+ /**
99
+ * Map severity order for filtering
100
+ */
101
+ const SEVERITY_ORDER = {
102
+ info: 0,
103
+ low: 1,
104
+ medium: 2,
105
+ high: 3,
106
+ critical: 4,
107
+ };
108
+ /**
109
+ * Convert DetectedSecret to CredentialFinding
110
+ */
111
+ function secretToFinding(secret, codeRoot) {
112
+ // Make file path relative to code_root
113
+ let relativePath = secret.file;
114
+ if (relativePath.startsWith(codeRoot)) {
115
+ relativePath = relativePath.slice(codeRoot.length);
116
+ if (relativePath.startsWith('/')) {
117
+ relativePath = relativePath.slice(1);
118
+ }
119
+ }
120
+ return {
121
+ kind: 'CREDENTIAL_EXPOSURE',
122
+ severity: secret.severity === 'low' ? 'low' : secret.severity,
123
+ location: {
124
+ file: relativePath,
125
+ span: [secret.line, secret.line], // Single line span
126
+ },
127
+ evidence: {
128
+ rule_id: secret.patternId,
129
+ match_snippet: secret.match, // Already redacted by scanner
130
+ confidence: secret.llmConfidence ?? (secret.category === 'high-entropy' ? 0.7 : 0.95),
131
+ },
132
+ suggested_action: getSuggestedAction(secret),
133
+ };
134
+ }
135
+ /** The one line a caller gets when `llm_verify` is asked for and not enabled. */
136
+ export const LLM_VERIFY_REFUSAL = 'find_credential_exposure: llm_verify needs a configured endpoint (COGNIUM_ENDPOINT) or a licence token, ' +
137
+ 'and this install has neither. Call again without llm_verify for the deterministic scan.';
138
+ export function registerFindCredentialExposure(server, ctx) {
139
+ server.registerTool('find_credential_exposure', {
140
+ title: 'Find Credential Exposure',
141
+ description: 'Scan a code root for hardcoded credentials (API keys, tokens, passwords, ' +
142
+ 'private keys). Uses SAST pattern matching and optional git history scanning. ' +
143
+ 'Returns findings with severity, location, and remediation guidance. ' +
144
+ 'Deterministic by default; llm_verify is LLM-backed and runs only when set.',
145
+ inputSchema,
146
+ outputSchema,
147
+ }, async ({ code_root, include_git_history, severity_floor, llm_verify, verify_budget }) => {
148
+ // Checked on every call, not inferred from the tool being listed. The
149
+ // engine treats a missing model as "skip verification"; asked for by
150
+ // name, that would be a quiet change of behaviour, so refuse instead.
151
+ const wantsLlm = llm_verify === true && (verify_budget ?? 0) > 0;
152
+ if (wantsLlm && !llmEnabled(ctx.enablement)) {
153
+ return refusal(LLM_VERIFY_REFUSAL);
154
+ }
155
+ // A configured endpoint is where the model is. With a licence token
156
+ // and no endpoint, the engine's own LLM_* configuration applies.
157
+ const endpoint = ctx.enablement.endpoint;
158
+ const llmConfig = wantsLlm && endpoint ? { baseUrl: endpoint } : undefined;
159
+ // Map severity_floor to scanner's minSeverity
160
+ const minSeverity = severity_floor === 'info' ? undefined :
161
+ severity_floor === 'low' ? 'low' :
162
+ severity_floor === 'medium' ? 'medium' :
163
+ severity_floor === 'high' ? 'high' :
164
+ severity_floor === 'critical' ? 'critical' :
165
+ 'low';
166
+ const scanResult = await scanForSecrets(code_root, {
167
+ scanHistory: include_git_history,
168
+ minSeverity,
169
+ maxCommits: 100, // Reasonable limit for git history
170
+ // REFACTOR-019: forward LLM verify controls. The engine handles the
171
+ // `llmVerify && verifyBudget > 0` precedence.
172
+ llmVerify: wantsLlm,
173
+ verifyBudget: verify_budget,
174
+ ...(llmConfig ? { llmConfig } : {}),
175
+ });
176
+ // Says `llm` only if a model actually judged something in this scan.
177
+ const verified = scanResult.secrets.some((s) => s.llmVerified !== undefined);
178
+ const provenance = verified
179
+ ? llmProvenance({ ...getDefaultLLMConfig(), ...llmConfig }.phases.verification.model)
180
+ : DETERMINISTIC;
181
+ // Filter by severity floor and convert to findings
182
+ const floorValue = SEVERITY_ORDER[severity_floor ?? 'low'];
183
+ const filteredSecrets = scanResult.secrets.filter((s) => SEVERITY_ORDER[s.severity] >= floorValue);
184
+ // Convert to findings format, respecting MAX_FINDINGS
185
+ const truncated = filteredSecrets.length > MAX_FINDINGS;
186
+ const findings = filteredSecrets
187
+ .slice(0, MAX_FINDINGS)
188
+ .map((s) => secretToFinding(s, code_root));
189
+ const result = {
190
+ findings,
191
+ summary: {
192
+ total: filteredSecrets.length,
193
+ by_severity: {
194
+ critical: filteredSecrets.filter((s) => s.severity === 'critical').length,
195
+ high: filteredSecrets.filter((s) => s.severity === 'high').length,
196
+ medium: filteredSecrets.filter((s) => s.severity === 'medium').length,
197
+ low: filteredSecrets.filter((s) => s.severity === 'low').length,
198
+ },
199
+ truncated,
200
+ },
201
+ };
202
+ return toolResult(result, provenance);
203
+ });
204
+ }
205
+ //# sourceMappingURL=find-credential-exposure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-credential-exposure.js","sourceRoot":"","sources":["../../../src/mcp/tools/find-credential-exposure.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * find_excessive_permissions MCP tool (Pillar I, Batch 2).
3
+ *
4
+ * Analyzes MCP server configurations for overly broad or dangerous permissions.
5
+ * Supports: skill bundle (mcp.json), Claude Desktop, Cursor configs.
6
+ *
7
+ * Auto-detection heuristic:
8
+ * - Files named mcp.json, .mcp.json, mcp-config.json → skill bundle format
9
+ * - claude_desktop_config.json → Claude Desktop format
10
+ * - .cursor/mcp.json → Cursor format
11
+ *
12
+ * @see https://github.com/cogniumhq/cognium-ai/issues/80
13
+ */
14
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
15
+ export declare function registerFindExcessivePermissions(server: McpServer): void;
16
+ //# sourceMappingURL=find-excessive-permissions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-excessive-permissions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/find-excessive-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmGzE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgExE"}
@@ -0,0 +1,143 @@
1
+ /**
2
+ * find_excessive_permissions MCP tool (Pillar I, Batch 2).
3
+ *
4
+ * Analyzes MCP server configurations for overly broad or dangerous permissions.
5
+ * Supports: skill bundle (mcp.json), Claude Desktop, Cursor configs.
6
+ *
7
+ * Auto-detection heuristic:
8
+ * - Files named mcp.json, .mcp.json, mcp-config.json → skill bundle format
9
+ * - claude_desktop_config.json → Claude Desktop format
10
+ * - .cursor/mcp.json → Cursor format
11
+ *
12
+ * @see https://github.com/cogniumhq/cognium-ai/issues/80
13
+ */
14
+ import { z } from 'zod';
15
+ import { DETERMINISTIC, provenanceSchema, toolResult } from '../result.js';
16
+ import { excessivePermissionsPass } from '../../trust/index.js';
17
+ import { loadCircleIR } from '../analysis.js';
18
+ const MAX_FINDINGS = 500;
19
+ const SEVERITY_ORDER = {
20
+ info: 0,
21
+ low: 1,
22
+ medium: 2,
23
+ high: 3,
24
+ critical: 4,
25
+ };
26
+ const inputSchema = {
27
+ code_root: z.string().describe('Absolute path to the code root to scan'),
28
+ severity_floor: z.enum(['info', 'low', 'medium', 'high', 'critical']).optional().default('low').describe('Minimum severity to report (default: low)'),
29
+ deep_analysis: z.boolean().optional().default(true).describe('Run CircleIR analysis to detect undisclosed capabilities (default: true)'),
30
+ };
31
+ const outputSchema = {
32
+ findings: z.array(z.object({
33
+ kind: z.literal('EXCESSIVE_PERMISSION'),
34
+ severity: z.enum(['low', 'medium', 'high', 'critical']),
35
+ location: z.object({
36
+ file: z.string(),
37
+ span: z.tuple([z.number(), z.number()]),
38
+ }),
39
+ evidence: z.object({
40
+ rule_id: z.string(),
41
+ config_file: z.string(),
42
+ permission_type: z.string(),
43
+ value: z.string(),
44
+ }),
45
+ suggested_action: z.string(),
46
+ })),
47
+ summary: z.object({
48
+ total: z.number(),
49
+ by_severity: z.object({
50
+ critical: z.number(),
51
+ high: z.number(),
52
+ medium: z.number(),
53
+ low: z.number(),
54
+ }),
55
+ truncated: z.boolean(),
56
+ }),
57
+ detection_info: z.object({
58
+ config_files_checked: z.array(z.string()),
59
+ auto_detection_heuristic: z.string(),
60
+ deep_analysis_performed: z.boolean(),
61
+ files_analyzed: z.number().optional(),
62
+ }),
63
+ provenance: provenanceSchema,
64
+ };
65
+ const SUGGESTED_ACTIONS = {
66
+ 'perm-broad-filesystem': 'Restrict filesystem access to specific directories needed by the tool. Avoid /home, /Users, or ~ wildcards.',
67
+ 'perm-secret-env-exposure': 'Remove sensitive environment variables from MCP config. Use secrets management instead.',
68
+ 'perm-unrestricted-network': 'Restrict network access to specific hosts/ports needed by the tool.',
69
+ 'perm-dangerous-command': 'Review and restrict allowed commands. Avoid shell interpreters and system utilities.',
70
+ 'perm-write-sensitive-path': 'Restrict write access to user-specific directories. Avoid system paths.',
71
+ };
72
+ function trustFindingToMcp(f) {
73
+ const meta = f.meta;
74
+ return {
75
+ kind: 'EXCESSIVE_PERMISSION',
76
+ severity: f.severity === 'info' ? 'low' : f.severity,
77
+ location: {
78
+ file: f.location?.file ?? 'mcp.json',
79
+ span: [f.location?.line ?? 1, f.location?.line ?? 1],
80
+ },
81
+ evidence: {
82
+ rule_id: f.ruleId,
83
+ config_file: f.location?.file ?? 'mcp.json',
84
+ permission_type: meta.permissionType ?? 'unknown',
85
+ value: meta.value ?? '',
86
+ },
87
+ suggested_action: SUGGESTED_ACTIONS[f.ruleId] ?? 'Review this permission for security risks and apply least-privilege principle.',
88
+ };
89
+ }
90
+ export function registerFindExcessivePermissions(server) {
91
+ server.registerTool('find_excessive_permissions', {
92
+ title: 'Find Excessive Permissions',
93
+ description: 'Analyze MCP server configurations for overly broad permissions. ' +
94
+ 'Detects: broad filesystem paths (/home, /Users, ~), secret env var exposure, ' +
95
+ 'unrestricted network access, dangerous command allowlisting. ' +
96
+ 'Auto-detects config format (skill bundle, Claude Desktop, Cursor).',
97
+ inputSchema,
98
+ outputSchema,
99
+ }, async ({ code_root, severity_floor, deep_analysis }) => {
100
+ // Run CircleIR analysis for deep capability detection
101
+ let circleIRResults;
102
+ if (deep_analysis !== false) {
103
+ try {
104
+ const { results } = await loadCircleIR(code_root);
105
+ circleIRResults = results;
106
+ }
107
+ catch {
108
+ // CircleIR analysis failed, continue with static-only analysis
109
+ }
110
+ }
111
+ const result = await excessivePermissionsPass(code_root, { circleIRResults });
112
+ const floorValue = SEVERITY_ORDER[severity_floor ?? 'low'];
113
+ const filtered = result.findings.filter((f) => SEVERITY_ORDER[f.severity] >= floorValue);
114
+ const truncated = filtered.length > MAX_FINDINGS;
115
+ const findings = filtered.slice(0, MAX_FINDINGS).map(trustFindingToMcp);
116
+ const output = {
117
+ findings,
118
+ summary: {
119
+ total: filtered.length,
120
+ by_severity: {
121
+ critical: filtered.filter((f) => f.severity === 'critical').length,
122
+ high: filtered.filter((f) => f.severity === 'high').length,
123
+ medium: filtered.filter((f) => f.severity === 'medium').length,
124
+ low: filtered.filter((f) => f.severity === 'low').length,
125
+ },
126
+ truncated,
127
+ },
128
+ detection_info: {
129
+ config_files_checked: [
130
+ 'mcp.json', '.mcp.json', 'mcp-config.json',
131
+ 'claude_desktop_config.json', '.cursor/mcp.json',
132
+ ],
133
+ auto_detection_heuristic: 'Files named mcp.json/.mcp.json/mcp-config.json use skill bundle format. ' +
134
+ 'claude_desktop_config.json uses Claude Desktop format. ' +
135
+ '.cursor/mcp.json uses Cursor format.',
136
+ deep_analysis_performed: !!circleIRResults,
137
+ files_analyzed: circleIRResults?.length,
138
+ },
139
+ };
140
+ return toolResult(output, DETERMINISTIC);
141
+ });
142
+ }
143
+ //# sourceMappingURL=find-excessive-permissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-excessive-permissions.js","sourceRoot":"","sources":["../../../src/mcp/tools/find-excessive-permissions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * find_install_script_risk MCP tool (Pillar I, Batch 2).
3
+ *
4
+ * Analyzes npm package.json lifecycle scripts for suspicious patterns.
5
+ * Scope: npm lifecycle scripts only (preinstall, install, postinstall, prepare, etc.)
6
+ *
7
+ * @see https://github.com/cogniumhq/cognium-ai/issues/80
8
+ */
9
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
10
+ export declare function registerFindInstallScriptRisk(server: McpServer): void;
11
+ //# sourceMappingURL=find-install-script-risk.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find-install-script-risk.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/find-install-script-risk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkGzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwCrE"}