infisical-mcp 1.0.1 → 1.0.2
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 +5 -5
- package/dist/api.d.ts +0 -2
- package/dist/api.js +0 -88
- package/dist/gateway.d.ts +16 -0
- package/dist/gateway.js +85 -0
- package/dist/server.js +6 -10
- package/package.json +1 -1
- package/dist/license.js +0 -79
package/README.md
CHANGED
|
@@ -23,18 +23,18 @@ Part of [awesome-mcps](https://github.com/mrfentmen/awesome-mcps).
|
|
|
23
23
|
<!-- paywall -->
|
|
24
24
|
## Premium tools
|
|
25
25
|
|
|
26
|
-
These tools need a
|
|
26
|
+
These tools need a licence key:
|
|
27
27
|
|
|
28
28
|
* `secret_entropy_audit`
|
|
29
29
|
* `secret_set_diff`
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:
|
|
32
32
|
|
|
33
33
|
```json
|
|
34
|
-
"env": { "MCP_LICENSE_KEY": "
|
|
34
|
+
"env": { "MCP_LICENSE_KEY": "polar_..." }
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
The
|
|
38
|
-
|
|
37
|
+
The gateway checks the key against Polar and gives every key 1,000 free premium
|
|
38
|
+
calls a month before per-call billing starts. Every other tool on this server
|
|
39
39
|
stays free.
|
|
40
40
|
<!-- /paywall -->
|
package/dist/api.d.ts
CHANGED
|
@@ -11,7 +11,6 @@ export interface InfisicalEntropyArgs {
|
|
|
11
11
|
secrets: string;
|
|
12
12
|
label?: string;
|
|
13
13
|
}
|
|
14
|
-
export declare function secretEntropyAudit(args: InfisicalEntropyArgs): Promise<string>;
|
|
15
14
|
export interface InfisicalNamesArgs {
|
|
16
15
|
names: string;
|
|
17
16
|
style?: string;
|
|
@@ -23,4 +22,3 @@ export interface InfisicalDiffArgs {
|
|
|
23
22
|
left_label?: string;
|
|
24
23
|
right_label?: string;
|
|
25
24
|
}
|
|
26
|
-
export declare function secretSetDiff(args: InfisicalDiffArgs): Promise<string>;
|
package/dist/api.js
CHANGED
|
@@ -250,43 +250,6 @@ function infValueIndex(pairs) {
|
|
|
250
250
|
}
|
|
251
251
|
return index;
|
|
252
252
|
}
|
|
253
|
-
export async function secretEntropyAudit(args) {
|
|
254
|
-
const pairs = infParsePairs(args.secrets ?? "");
|
|
255
|
-
if (pairs.length === 0) {
|
|
256
|
-
return "Send the secret material to audit as KEY=value lines (or a JSON object), e.g. STRIPE_KEY=sk_live_9fJ2kQp81x.";
|
|
257
|
-
}
|
|
258
|
-
const seen = infValueIndex(pairs);
|
|
259
|
-
const rows = pairs.map((p) => {
|
|
260
|
-
const pool = infPool(p.value);
|
|
261
|
-
const bits = p.value.length > 0 && pool > 1 ? p.value.length * Math.log2(pool) : 0;
|
|
262
|
-
return {
|
|
263
|
-
key: p.key,
|
|
264
|
-
value: p.value,
|
|
265
|
-
bits,
|
|
266
|
-
perChar: p.value.length > 0 ? infEntropyPerChar(p.value) : 0,
|
|
267
|
-
flags: infFlags(p.key, p.value, seen),
|
|
268
|
-
};
|
|
269
|
-
});
|
|
270
|
-
const risky = rows.filter((r) => r.flags.length > 0);
|
|
271
|
-
const weak = rows.filter((r) => r.bits < 60).sort((a, b) => a.bits - b.bits);
|
|
272
|
-
const lines = [
|
|
273
|
-
`${rows.length} secret(s) audited${args.label ? ` from ${args.label}` : ""}. Values are measured, never printed.`,
|
|
274
|
-
"",
|
|
275
|
-
"bits = length x log2(charset size), the standard estimate of brute-force search space.",
|
|
276
|
-
...rows.map((r) => {
|
|
277
|
-
const head = `${r.key}: ${r.bits.toFixed(1)} bits (${r.perChar.toFixed(2)} bits/char, ${infStrength(r.bits, r.value)})`;
|
|
278
|
-
return r.flags.length ? `${head}\n - ${r.flags.join("\n - ")}` : head;
|
|
279
|
-
}),
|
|
280
|
-
"",
|
|
281
|
-
`Flagged: ${risky.length} of ${rows.length}.`,
|
|
282
|
-
];
|
|
283
|
-
if (weak.length) {
|
|
284
|
-
lines.push(`Weakest first: ${weak.slice(0, 5).map((r) => `${r.key} (${r.bits.toFixed(0)} bits)`).join(", ")}.`);
|
|
285
|
-
}
|
|
286
|
-
if (!risky.length && !weak.length)
|
|
287
|
-
lines.push("No placeholder, reuse, sequence or charset problems found.");
|
|
288
|
-
return lines.join("\n");
|
|
289
|
-
}
|
|
290
253
|
function infStyleOf(name) {
|
|
291
254
|
if (/^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$/.test(name))
|
|
292
255
|
return "SHOUTING_SNAKE_CASE";
|
|
@@ -362,54 +325,3 @@ export async function secretNameHygiene(args) {
|
|
|
362
325
|
function infNormalise(value) {
|
|
363
326
|
return value.trim().toLowerCase();
|
|
364
327
|
}
|
|
365
|
-
export async function secretSetDiff(args) {
|
|
366
|
-
const leftName = (args.left_label ?? "left set").trim() || "left set";
|
|
367
|
-
const rightName = (args.right_label ?? "right set").trim() || "right set";
|
|
368
|
-
const left = infParsePairs(args.left ?? "");
|
|
369
|
-
const right = infParsePairs(args.right ?? "");
|
|
370
|
-
if (left.length === 0 && right.length === 0) {
|
|
371
|
-
return "Send both sets as KEY=value lines. Fill in at least one of them.";
|
|
372
|
-
}
|
|
373
|
-
const leftMap = new Map(left.map((p) => [p.key, p.value]));
|
|
374
|
-
const rightMap = new Map(right.map((p) => [p.key, p.value]));
|
|
375
|
-
const onlyLeft = [...leftMap.keys()].filter((k) => !rightMap.has(k));
|
|
376
|
-
const onlyRight = [...rightMap.keys()].filter((k) => !leftMap.has(k));
|
|
377
|
-
const shared = [...leftMap.keys()].filter((k) => rightMap.has(k));
|
|
378
|
-
const changed = [];
|
|
379
|
-
const caseOnly = [];
|
|
380
|
-
for (const k of shared) {
|
|
381
|
-
const a = leftMap.get(k);
|
|
382
|
-
const b = rightMap.get(k);
|
|
383
|
-
if (a === b)
|
|
384
|
-
continue;
|
|
385
|
-
if (infNormalise(a) === infNormalise(b))
|
|
386
|
-
caseOnly.push(k);
|
|
387
|
-
else
|
|
388
|
-
changed.push(k);
|
|
389
|
-
}
|
|
390
|
-
const leftDupes = infValueIndex(left);
|
|
391
|
-
const rightDupes = infValueIndex(right);
|
|
392
|
-
const rightValues = new Set(right.map((p) => p.value).filter(Boolean));
|
|
393
|
-
const crossShared = left.filter((p) => p.value && rightValues.has(p.value)).length;
|
|
394
|
-
const dupeNote = (name, index) => [...index.entries()]
|
|
395
|
-
.filter(([, keys]) => keys.length > 1)
|
|
396
|
-
.map(([value, keys]) => `${name}: ${keys.join(", ")} share one value (${value.length} chars)`)
|
|
397
|
-
.slice(0, 5);
|
|
398
|
-
return [
|
|
399
|
-
`${leftName}: ${left.length} key(s). ${rightName}: ${right.length} key(s). ${shared.length} in both. Values are never printed.`,
|
|
400
|
-
"",
|
|
401
|
-
onlyLeft.length ? `Only in ${leftName} (${onlyLeft.length}): ${onlyLeft.slice(0, 20).join(", ")}` : `Only in ${leftName}: none.`,
|
|
402
|
-
onlyRight.length ? `Only in ${rightName} (${onlyRight.length}): ${onlyRight.slice(0, 20).join(", ")}` : `Only in ${rightName}: none.`,
|
|
403
|
-
changed.length
|
|
404
|
-
? `Different values (${changed.length}): ${changed.slice(0, 20).join(", ")}`
|
|
405
|
-
: "Different values: none.",
|
|
406
|
-
caseOnly.length
|
|
407
|
-
? `Differ only by case/whitespace (${caseOnly.length}): ${caseOnly.slice(0, 10).join(", ")}`
|
|
408
|
-
: "Differ only by case/whitespace: none.",
|
|
409
|
-
...dupeNote(leftName, leftDupes),
|
|
410
|
-
...dupeNote(rightName, rightDupes),
|
|
411
|
-
crossShared > 0 ? `${crossShared} value(s) are reused across the two sets.` : "No values reused across the two sets.",
|
|
412
|
-
]
|
|
413
|
-
.filter(Boolean)
|
|
414
|
-
.join("\n");
|
|
415
|
-
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Thin client for the premium gateway.
|
|
3
|
+
*
|
|
4
|
+
* The premium tools do not run in this package any more. Their bodies live on
|
|
5
|
+
* the gateway, which checks a Polar licence key before it does any work, so
|
|
6
|
+
* deleting anything here buys nothing: the answer only exists behind the gate.
|
|
7
|
+
*
|
|
8
|
+
* Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
|
|
9
|
+
* endpoint, which is only useful for testing.
|
|
10
|
+
*/
|
|
11
|
+
/** Raised when a premium call cannot be completed. `message` is safe to show. */
|
|
12
|
+
export declare class GatewayError extends Error {
|
|
13
|
+
readonly refused: boolean;
|
|
14
|
+
constructor(message: string, refused: boolean);
|
|
15
|
+
}
|
|
16
|
+
export declare function premiumTool(tool: string, args: Record<string, unknown>): Promise<string>;
|
package/dist/gateway.js
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Thin client for the premium gateway.
|
|
3
|
+
*
|
|
4
|
+
* The premium tools do not run in this package any more. Their bodies live on
|
|
5
|
+
* the gateway, which checks a Polar licence key before it does any work, so
|
|
6
|
+
* deleting anything here buys nothing: the answer only exists behind the gate.
|
|
7
|
+
*
|
|
8
|
+
* Set `MCP_LICENSE_KEY` to a Polar licence key. `MCP_GATEWAY_URL` overrides the
|
|
9
|
+
* endpoint, which is only useful for testing.
|
|
10
|
+
*/
|
|
11
|
+
const DEFAULT_GATEWAY_URL = 'https://mcp-gateway.contactae2000.workers.dev/mcp';
|
|
12
|
+
const DEFAULT_TIMEOUT_MS = 25000;
|
|
13
|
+
const USER_AGENT = 'mrfentmen-mcp/1.0';
|
|
14
|
+
/** Raised when a premium call cannot be completed. `message` is safe to show. */
|
|
15
|
+
export class GatewayError extends Error {
|
|
16
|
+
refused;
|
|
17
|
+
constructor(message, refused) {
|
|
18
|
+
super(message);
|
|
19
|
+
this.refused = refused;
|
|
20
|
+
this.name = 'GatewayError';
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
export async function premiumTool(tool, args) {
|
|
24
|
+
const key = (process.env.MCP_LICENSE_KEY ?? '').trim();
|
|
25
|
+
if (!key) {
|
|
26
|
+
throw new GatewayError(`"${tool}" is a premium tool and no licence key is set. Set MCP_LICENSE_KEY in your MCP client config.`, true);
|
|
27
|
+
}
|
|
28
|
+
const url = (process.env.MCP_GATEWAY_URL ?? DEFAULT_GATEWAY_URL).trim();
|
|
29
|
+
const controller = new AbortController();
|
|
30
|
+
const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
|
|
31
|
+
let response;
|
|
32
|
+
try {
|
|
33
|
+
response = await fetch(url, {
|
|
34
|
+
method: 'POST',
|
|
35
|
+
headers: {
|
|
36
|
+
'content-type': 'application/json',
|
|
37
|
+
accept: 'application/json',
|
|
38
|
+
'user-agent': USER_AGENT,
|
|
39
|
+
authorization: `Bearer ${key}`,
|
|
40
|
+
},
|
|
41
|
+
body: JSON.stringify({
|
|
42
|
+
jsonrpc: '2.0',
|
|
43
|
+
id: 1,
|
|
44
|
+
method: 'tools/call',
|
|
45
|
+
params: { name: tool, arguments: args },
|
|
46
|
+
}),
|
|
47
|
+
signal: controller.signal,
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
throw new GatewayError(`"${tool}" could not reach the licence gateway. Check your connection and try again.`, false);
|
|
52
|
+
}
|
|
53
|
+
finally {
|
|
54
|
+
clearTimeout(timer);
|
|
55
|
+
}
|
|
56
|
+
if (!response.ok) {
|
|
57
|
+
throw new GatewayError(`"${tool}" could not reach the licence gateway (HTTP ${response.status}).`, false);
|
|
58
|
+
}
|
|
59
|
+
let body;
|
|
60
|
+
try {
|
|
61
|
+
body = (await response.json());
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
throw new GatewayError(`"${tool}" got an unreadable answer from the licence gateway.`, false);
|
|
65
|
+
}
|
|
66
|
+
if (body.error) {
|
|
67
|
+
throw new GatewayError(`"${tool}" was refused by the licence gateway: ${body.error.message ?? 'unknown error'}`, false);
|
|
68
|
+
}
|
|
69
|
+
const result = body.result ?? {};
|
|
70
|
+
const text = (result.content ?? [])
|
|
71
|
+
.map((part) => part.text ?? '')
|
|
72
|
+
.join('\n')
|
|
73
|
+
.trim();
|
|
74
|
+
if (result.isError) {
|
|
75
|
+
// The gateway marks a licence refusal structurally, so a missing or rejected
|
|
76
|
+
// key is told apart from a tool that failed after the gate let it through.
|
|
77
|
+
if (result.structuredContent?.licenceRefusal) {
|
|
78
|
+
throw new GatewayError(text || `"${tool}" needs a valid licence key.`, true);
|
|
79
|
+
}
|
|
80
|
+
throw new GatewayError(text || `"${tool}" failed on the licence gateway.`, false);
|
|
81
|
+
}
|
|
82
|
+
if (!text)
|
|
83
|
+
throw new GatewayError(`"${tool}" returned no data.`, false);
|
|
84
|
+
return text;
|
|
85
|
+
}
|
package/dist/server.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
2
|
import { z } from "zod";
|
|
3
|
-
import { errorMessage, listSecrets, getSecret, createSecret, updateSecret, deleteSecret,
|
|
4
|
-
import {
|
|
3
|
+
import { errorMessage, listSecrets, getSecret, createSecret, updateSecret, deleteSecret, secretNameHygiene } from "./api.js";
|
|
4
|
+
import { premiumTool } from "./gateway.js";
|
|
5
5
|
const text = (t) => ({ content: [{ type: "text", text: t }] });
|
|
6
6
|
const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
|
|
7
7
|
const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
|
|
@@ -112,12 +112,10 @@ export function createServer() {
|
|
|
112
112
|
annotations: READ_ONLY,
|
|
113
113
|
}, async (args) => {
|
|
114
114
|
// ---- paywall: secret_entropy_audit ----
|
|
115
|
-
|
|
116
|
-
if (paywallMessage)
|
|
117
|
-
return { content: [{ type: "text", text: paywallMessage }], isError: true };
|
|
115
|
+
// The body runs on the gateway, behind the licence gate.
|
|
118
116
|
// ---- paywall: end ----
|
|
119
117
|
try {
|
|
120
|
-
return text(await
|
|
118
|
+
return text(await premiumTool("mcp_infisical_secret_entropy_audit", args));
|
|
121
119
|
}
|
|
122
120
|
catch (e) {
|
|
123
121
|
return textError(errorMessage(e));
|
|
@@ -151,12 +149,10 @@ export function createServer() {
|
|
|
151
149
|
annotations: READ_ONLY,
|
|
152
150
|
}, async (args) => {
|
|
153
151
|
// ---- paywall: secret_set_diff ----
|
|
154
|
-
|
|
155
|
-
if (paywallMessage)
|
|
156
|
-
return { content: [{ type: "text", text: paywallMessage }], isError: true };
|
|
152
|
+
// The body runs on the gateway, behind the licence gate.
|
|
157
153
|
// ---- paywall: end ----
|
|
158
154
|
try {
|
|
159
|
-
return text(await
|
|
155
|
+
return text(await premiumTool("mcp_infisical_secret_set_diff", args));
|
|
160
156
|
}
|
|
161
157
|
catch (e) {
|
|
162
158
|
return textError(errorMessage(e));
|
package/package.json
CHANGED
package/dist/license.js
DELETED
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
// Premium tools on this server need a license key bought from MCP Marketplace.
|
|
2
|
-
// Buyers put the key in their MCP client config as MCP_LICENSE_KEY. Every tool
|
|
3
|
-
// that is not listed in PREMIUM keeps working without a key.
|
|
4
|
-
const SLUG = "infisical-mcp";
|
|
5
|
-
// Tools that need a key. Everything else is free.
|
|
6
|
-
const PREMIUM = new Set([
|
|
7
|
-
"secret_entropy_audit",
|
|
8
|
-
"secret_set_diff",
|
|
9
|
-
]);
|
|
10
|
-
const BUY_URL = `https://mcp-marketplace.io/server/io-github-mrfentmen-${SLUG}`;
|
|
11
|
-
// The license check calls the marketplace's verify endpoint directly instead of
|
|
12
|
-
// using @mcp_marketplace/license. That SDK sends no `apikey` header, so every
|
|
13
|
-
// check it makes is rejected by Supabase before it reaches the function. The
|
|
14
|
-
// publishable key below is public by design - it ships in mcp-marketplace.io's
|
|
15
|
-
// own JavaScript and only ever reaches their licence check.
|
|
16
|
-
const DEFAULT_VERIFY_URL = "https://virupvwhtkpkjsiskckg.supabase.co/functions/v1/verify-key";
|
|
17
|
-
const PUBLISHABLE_KEY = "sb_publishable_BuqlW96Ke8C_zzJG-LQv1Q_YHi_r_4h";
|
|
18
|
-
const OK_CACHE_MS = 60 * 60 * 1000;
|
|
19
|
-
const BAD_CACHE_MS = 60 * 1000;
|
|
20
|
-
const seen = new Map();
|
|
21
|
-
const REASONS = {
|
|
22
|
-
missing_key: "no key is set",
|
|
23
|
-
invalid_format: "that key is not a valid MCP Marketplace key",
|
|
24
|
-
not_found: "that key was not found",
|
|
25
|
-
revoked: "that key has been revoked",
|
|
26
|
-
rotated: "that key was rotated, use your new one",
|
|
27
|
-
expired: "that key has expired, renew it",
|
|
28
|
-
rate_limited: "there were too many checks just now, try again shortly",
|
|
29
|
-
network_error: "the license server could not be reached",
|
|
30
|
-
};
|
|
31
|
-
function blocked(tool, reason) {
|
|
32
|
-
const why = REASONS[reason] ?? `the license server answered "${reason}"`;
|
|
33
|
-
return `"${tool}" needs a license key, but ${why}. ` +
|
|
34
|
-
`Set MCP_LICENSE_KEY in your MCP client config. Get a key: ${BUY_URL}`;
|
|
35
|
-
}
|
|
36
|
-
async function verify(key) {
|
|
37
|
-
const res = await fetch(process.env.MCP_LICENSE_VERIFY_URL || DEFAULT_VERIFY_URL, {
|
|
38
|
-
method: "POST",
|
|
39
|
-
headers: {
|
|
40
|
-
apikey: PUBLISHABLE_KEY,
|
|
41
|
-
Authorization: `Bearer ${PUBLISHABLE_KEY}`,
|
|
42
|
-
"Content-Type": "application/json",
|
|
43
|
-
},
|
|
44
|
-
body: JSON.stringify({ key, slug: SLUG }),
|
|
45
|
-
// an unusable key answers 400 with a JSON body, so read the body either way
|
|
46
|
-
signal: AbortSignal.timeout(15000),
|
|
47
|
-
});
|
|
48
|
-
const data = (await res.json());
|
|
49
|
-
if (typeof data?.valid !== "boolean")
|
|
50
|
-
return { valid: false, reason: "unexpected_response" };
|
|
51
|
-
return data;
|
|
52
|
-
}
|
|
53
|
-
/**
|
|
54
|
-
* Returns null when the caller may run the tool, or a short message telling
|
|
55
|
-
* them how to get a key.
|
|
56
|
-
*
|
|
57
|
-
* A good key is remembered for an hour, so a busy session does not hit the
|
|
58
|
-
* license server on every call and keeps working through a brief outage.
|
|
59
|
-
*/
|
|
60
|
-
export async function premiumRequired(tool) {
|
|
61
|
-
if (!PREMIUM.has(tool))
|
|
62
|
-
return null;
|
|
63
|
-
const key = process.env.MCP_LICENSE_KEY;
|
|
64
|
-
if (!key)
|
|
65
|
-
return blocked(tool, "missing_key");
|
|
66
|
-
const hit = seen.get(key);
|
|
67
|
-
if (hit && Date.now() - hit.at < (hit.valid ? OK_CACHE_MS : BAD_CACHE_MS)) {
|
|
68
|
-
return hit.valid ? null : blocked(tool, hit.reason ?? "invalid");
|
|
69
|
-
}
|
|
70
|
-
let result;
|
|
71
|
-
try {
|
|
72
|
-
result = await verify(key);
|
|
73
|
-
}
|
|
74
|
-
catch {
|
|
75
|
-
result = { valid: false, reason: "network_error" };
|
|
76
|
-
}
|
|
77
|
-
seen.set(key, { ...result, at: Date.now() });
|
|
78
|
-
return result.valid ? null : blocked(tool, result.reason ?? "invalid");
|
|
79
|
-
}
|