mcp-xray-pilot 0.10.0

package/dist/validate.js

@@ -0,0 +1,408 @@
+/*
+ * Structural validator for xray-core configs.
+ *
+ * v0.2+ scope:
+ *   - JSON parse safety
+ *   - Top-level shape: at minimum `inbounds[]` AND `outbounds[]` must exist
+ *   - Each inbound/outbound has `tag` and a known `protocol`
+ *   - Per-protocol Zod schema for `settings`
+ *   - streamSettings.network and matching *Settings block via Zod
+ *   - streamSettings.security ("tls" / "reality") *Settings via Zod
+ *   - Cross-network and cross-security leftover *Settings warning
+ *   - All routing.rules tag references resolve to existing inbound/outbound tags
+ *   - Basic type sanity for `port`, `listen`
+ */
+import { inboundProtocolSchemas, outboundProtocolSchemas, } from "./schemas/protocols/index.js";
+import { allSettingsKeys, transportByNetwork, } from "./schemas/transports/index.js";
+import { allSecuritySettingsKeys, securityByName, } from "./schemas/security/index.js";
+const KNOWN_INBOUND_PROTOCOLS = new Set([
+    "vless",
+    "vmess",
+    "trojan",
+    "shadowsocks",
+    "socks",
+    "http",
+    "wireguard",
+    "hysteria2",
+    "hysteria",
+    "tunnel",
+    "dokodemo-door",
+    "tun",
+]);
+const KNOWN_OUTBOUND_PROTOCOLS = new Set([
+    "vless",
+    "vmess",
+    "trojan",
+    "shadowsocks",
+    "socks",
+    "http",
+    "wireguard",
+    "hysteria2",
+    "hysteria",
+    "freedom",
+    "blackhole",
+    "loopback",
+    "dns",
+]);
+function isObject(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function zodPath(issue) {
+    if (!issue.path.length)
+        return "";
+    return "/" + issue.path.map(String).join("/");
+}
+function pushZodIssues(issues, basePath, zodIssues, idPrefix) {
+    for (const z of zodIssues) {
+        issues.push({
+            id: `${idPrefix}_${z.code}`,
+            severity: "error",
+            message: z.message,
+            where: basePath + zodPath(z),
+        });
+    }
+}
+export function validateConfig(jsonText) {
+    const issues = [];
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch (err) {
+        issues.push({
+            id: "bad_json",
+            severity: "error",
+            message: `Config is not valid JSON: ${err.message}`,
+        });
+        return { ok: false, parsed: null, issues };
+    }
+    if (!isObject(parsed)) {
+        issues.push({
+            id: "not_object",
+            severity: "error",
+            message: "Top-level must be a JSON object.",
+            where: "/",
+        });
+        return { ok: false, parsed, issues };
+    }
+    const inbounds = parsed["inbounds"];
+    const outbounds = parsed["outbounds"];
+    if (!Array.isArray(inbounds) || inbounds.length === 0) {
+        issues.push({
+            id: "missing_inbounds",
+            severity: "error",
+            message: "Required `inbounds[]` is missing or empty.",
+            where: "/inbounds",
+        });
+    }
+    if (!Array.isArray(outbounds) || outbounds.length === 0) {
+        issues.push({
+            id: "missing_outbounds",
+            severity: "error",
+            message: "Required `outbounds[]` is missing or empty.",
+            where: "/outbounds",
+        });
+    }
+    const inboundTags = new Set();
+    if (Array.isArray(inbounds)) {
+        inbounds.forEach((ib, i) => validateInbound(ib, i, issues, inboundTags));
+    }
+    const outboundTags = new Set();
+    if (Array.isArray(outbounds)) {
+        outbounds.forEach((ob, i) => validateOutbound(ob, i, issues, outboundTags));
+    }
+    /* routing rules cross-checks */
+    const routing = parsed["routing"];
+    if (isObject(routing) && Array.isArray(routing["rules"])) {
+        routing["rules"].forEach((rule, i) => {
+            if (!isObject(rule))
+                return;
+            const path = `/routing/rules/${i}`;
+            const ot = rule["outboundTag"];
+            if (typeof ot === "string" && ot && !outboundTags.has(ot)) {
+                issues.push({
+                    id: "dangling_outbound_tag",
+                    severity: "error",
+                    message: `routing.rule references unknown outboundTag "${ot}"`,
+                    where: `${path}/outboundTag`,
+                });
+            }
+            const its = rule["inboundTag"];
+            const itArr = Array.isArray(its) ? its : its ? [its] : [];
+            itArr.forEach((tag, j) => {
+                if (typeof tag === "string" && tag && !inboundTags.has(tag)) {
+                    issues.push({
+                        id: "dangling_inbound_tag",
+                        severity: "error",
+                        message: `routing.rule references unknown inboundTag "${tag}"`,
+                        where: `${path}/inboundTag/${j}`,
+                    });
+                }
+            });
+            if (rule["type"] !== undefined && rule["type"] !== "field") {
+                issues.push({
+                    id: "rule_type_must_be_field",
+                    severity: "warn",
+                    message: `routing.rule.type should be "field" (got ${JSON.stringify(rule["type"])})`,
+                    where: `${path}/type`,
+                });
+            }
+            if (rule["outboundTag"] && rule["balancerTag"]) {
+                issues.push({
+                    id: "rule_outbound_balancer_conflict",
+                    severity: "error",
+                    message: "routing.rule has both outboundTag and balancerTag (mutually exclusive).",
+                    where: path,
+                });
+            }
+        });
+    }
+    const fatal = issues.some((i) => i.severity === "error");
+    return { ok: !fatal, parsed, issues };
+}
+function validateStreamSettings(ss, basePath, issues) {
+    if (!isObject(ss))
+        return;
+    const ssPath = `${basePath}/streamSettings`;
+    const network = ss["network"];
+    if (network !== undefined && typeof network !== "string") {
+        issues.push({
+            id: "stream_network_not_string",
+            severity: "error",
+            message: "streamSettings.network must be a string.",
+            where: `${ssPath}/network`,
+        });
+    }
+    else if (typeof network === "string" && network) {
+        const spec = transportByNetwork[network];
+        if (!spec) {
+            issues.push({
+                id: "stream_network_unknown",
+                severity: "warn",
+                message: `Unknown streamSettings.network "${network}".`,
+                where: `${ssPath}/network`,
+            });
+        }
+        else {
+            /* Validate the matching *Settings block. */
+            const block = ss[spec.settingsKey];
+            if (block !== undefined) {
+                const r = spec.schema.safeParse(block);
+                if (!r.success) {
+                    pushZodIssues(issues, `${ssPath}/${spec.settingsKey}`, r.error.issues, spec.settingsKey);
+                }
+            }
+            /* Cross-network leftovers: another *Settings present besides current? */
+            for (const key of allSettingsKeys) {
+                if (key === spec.settingsKey)
+                    continue;
+                if (ss[key] !== undefined) {
+                    issues.push({
+                        id: "stream_settings_cross_network",
+                        severity: "warn",
+                        message: `streamSettings.network="${network}" but ${key} is also set — xray will ignore it.`,
+                        where: `${ssPath}/${key}`,
+                    });
+                }
+            }
+        }
+    }
+    const security = ss["security"];
+    if (security !== undefined && typeof security !== "string") {
+        issues.push({
+            id: "stream_security_not_string",
+            severity: "error",
+            message: "streamSettings.security must be a string.",
+            where: `${ssPath}/security`,
+        });
+    }
+    else if (typeof security === "string" && security && security !== "none") {
+        const spec = securityByName[security];
+        if (!spec) {
+            issues.push({
+                id: "stream_security_unknown",
+                severity: "warn",
+                message: `Unknown streamSettings.security "${security}".`,
+                where: `${ssPath}/security`,
+            });
+        }
+        else {
+            const block = ss[spec.settingsKey];
+            if (block !== undefined) {
+                const r = spec.schema.safeParse(block);
+                if (!r.success) {
+                    pushZodIssues(issues, `${ssPath}/${spec.settingsKey}`, r.error.issues, spec.settingsKey);
+                }
+            }
+            for (const key of allSecuritySettingsKeys) {
+                if (key === spec.settingsKey)
+                    continue;
+                if (ss[key] !== undefined) {
+                    issues.push({
+                        id: "stream_security_cross",
+                        severity: "warn",
+                        message: `streamSettings.security="${security}" but ${key} is also set — xray will ignore it.`,
+                        where: `${ssPath}/${key}`,
+                    });
+                }
+            }
+        }
+    }
+}
+function validateInbound(ib, i, issues, tags) {
+    const path = `/inbounds/${i}`;
+    if (!isObject(ib)) {
+        issues.push({
+            id: "inbound_not_object",
+            severity: "error",
+            message: "inbound entry must be an object.",
+            where: path,
+        });
+        return;
+    }
+    const tag = ib["tag"];
+    if (typeof tag !== "string" || !tag) {
+        issues.push({
+            id: "inbound_missing_tag",
+            severity: "error",
+            message: "inbound is missing required `tag`.",
+            where: `${path}/tag`,
+        });
+    }
+    else {
+        if (tags.has(tag)) {
+            issues.push({
+                id: "duplicate_inbound_tag",
+                severity: "error",
+                message: `Duplicate inbound tag "${tag}".`,
+                where: `${path}/tag`,
+            });
+        }
+        tags.add(tag);
+    }
+    const proto = ib["protocol"];
+    if (typeof proto !== "string" || !proto) {
+        issues.push({
+            id: "inbound_missing_protocol",
+            severity: "error",
+            message: "inbound is missing required `protocol`.",
+            where: `${path}/protocol`,
+        });
+    }
+    else if (!KNOWN_INBOUND_PROTOCOLS.has(proto)) {
+        issues.push({
+            id: "inbound_unknown_protocol",
+            severity: "warn",
+            message: `Unknown inbound protocol "${proto}". Known: ${[...KNOWN_INBOUND_PROTOCOLS].join(", ")}.`,
+            where: `${path}/protocol`,
+        });
+    }
+    const port = ib["port"];
+    if (port !== undefined) {
+        const okType = typeof port === "number" ||
+            (typeof port === "string" && /^[0-9,\-]+$/.test(port));
+        if (!okType) {
+            issues.push({
+                id: "inbound_bad_port_type",
+                severity: "error",
+                message: "inbound.port must be a number, range string, or comma-list.",
+                where: `${path}/port`,
+            });
+        }
+    }
+    const listen = ib["listen"];
+    if (listen !== undefined && typeof listen !== "string") {
+        issues.push({
+            id: "inbound_bad_listen_type",
+            severity: "error",
+            message: "inbound.listen must be a string IP/hostname.",
+            where: `${path}/listen`,
+        });
+    }
+    /* Per-protocol settings deep validation. */
+    if (typeof proto === "string" && proto in inboundProtocolSchemas) {
+        const settings = ib["settings"];
+        if (settings === undefined) {
+            issues.push({
+                id: "inbound_missing_settings",
+                severity: "warn",
+                message: `inbound protocol "${proto}" usually requires settings{}.`,
+                where: `${path}/settings`,
+            });
+        }
+        else {
+            const r = inboundProtocolSchemas[proto].safeParse(settings);
+            if (!r.success) {
+                pushZodIssues(issues, `${path}/settings`, r.error.issues, "inbound_settings");
+            }
+        }
+    }
+    /* Stream/transport/security validation. */
+    if (ib["streamSettings"] !== undefined) {
+        validateStreamSettings(ib["streamSettings"], path, issues);
+    }
+}
+function validateOutbound(ob, i, issues, tags) {
+    const path = `/outbounds/${i}`;
+    if (!isObject(ob)) {
+        issues.push({
+            id: "outbound_not_object",
+            severity: "error",
+            message: "outbound entry must be an object.",
+            where: path,
+        });
+        return;
+    }
+    const tag = ob["tag"];
+    if (typeof tag === "string" && tag) {
+        if (tags.has(tag)) {
+            issues.push({
+                id: "duplicate_outbound_tag",
+                severity: "error",
+                message: `Duplicate outbound tag "${tag}".`,
+                where: `${path}/tag`,
+            });
+        }
+        tags.add(tag);
+    }
+    else if (i > 0) {
+        /* only the first/default outbound can omit tag in xray; warn for clarity. */
+        issues.push({
+            id: "outbound_missing_tag",
+            severity: "warn",
+            message: "outbound has no `tag`; routing.rules cannot reference it.",
+            where: `${path}/tag`,
+        });
+    }
+    const proto = ob["protocol"];
+    if (typeof proto !== "string" || !proto) {
+        issues.push({
+            id: "outbound_missing_protocol",
+            severity: "error",
+            message: "outbound is missing required `protocol`.",
+            where: `${path}/protocol`,
+        });
+    }
+    else if (!KNOWN_OUTBOUND_PROTOCOLS.has(proto)) {
+        issues.push({
+            id: "outbound_unknown_protocol",
+            severity: "warn",
+            message: `Unknown outbound protocol "${proto}". Known: ${[...KNOWN_OUTBOUND_PROTOCOLS].join(", ")}.`,
+            where: `${path}/protocol`,
+        });
+    }
+    if (typeof proto === "string" && proto in outboundProtocolSchemas) {
+        const settings = ob["settings"];
+        /* Several outbound protocols (freedom, blackhole) don't require settings. */
+        if (settings !== undefined) {
+            const r = outboundProtocolSchemas[proto].safeParse(settings);
+            if (!r.success) {
+                pushZodIssues(issues, `${path}/settings`, r.error.issues, "outbound_settings");
+            }
+        }
+    }
+    if (ob["streamSettings"] !== undefined) {
+        validateStreamSettings(ob["streamSettings"], path, issues);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "mcp-xray-pilot",
+  "version": "0.10.0",
+  "description": "MCP server for xray-core: offline docs cache (auto-refresh), config validation, REALITY/XTLS lint, anti-DPI recipes, GitHub research from XTLS repos.",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-xray-pilot": "dist/index.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "beekamai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/beekamai/mcp-xray-pilot.git"
+  },
+  "homepage": "https://github.com/beekamai/mcp-xray-pilot#readme",
+  "bugs": {
+    "url": "https://github.com/beekamai/mcp-xray-pilot/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "xray",
+    "xray-core",
+    "vless",
+    "reality",
+    "vmess",
+    "trojan",
+    "shadowsocks",
+    "vpn",
+    "anti-dpi",
+    "rkn",
+    "tspu",
+    "claude",
+    "claude-code"
+  ],
+  "files": [
+    "dist",
+    "data/docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "fetch-docs": "tsx scripts/fetch-docs.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  }
+}