@shell-shock/plugin-mcp 0.1.1

package/dist/index.cjs

@@ -0,0 +1,79 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_components_mcp_command = require('./components/mcp-command.cjs');
+const require_generator = require('./generator.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _shell_shock_core_helpers_power_plant = require("@shell-shock/core/helpers/power-plant");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+
+//#region src/index.tsx
+/**
+* A Shell Shock plugin that generates an MCP server command from the resolved command tree.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock/mcp",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `mcp` plugin.");
+			const commandName = (0, _stryke_type_checks_is_set_string.isSetString)(options.command) ? options.command : null;
+			const commandConfig = typeof options.command === "object" && options.command ? options.command : {};
+			return { mcp: (0, defu.defu)({ command: { name: commandName ?? commandConfig.name ?? "mcp" } }, {
+				...options,
+				command: commandConfig
+			}) };
+		},
+		async configResolved() {
+			const _self$ = this;
+			this.debug("Adding the CLI mcp command to the application context.");
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === this.config.mcp.command.name)) {
+				this.info("The `mcp` command already exists in the commands list. If you would like the mcp command to be managed by the `@shell-shock/plugin-mcp` package, please remove or rename the command.");
+				return;
+			}
+			const { entry: commandEntry, ...commandOverrides } = this.config.mcp.command;
+			const mcpCommand = {
+				...commandOverrides,
+				id: this.config.mcp.command.name,
+				name: this.config.mcp.command.name,
+				path: this.config.mcp.command.name,
+				segments: [this.config.mcp.command.name],
+				title: "Model Context Protocol (MCP) Server",
+				icon: "🔌",
+				alias: [],
+				tags: ["AI"],
+				description: "Start a Model Context Protocol (MCP) stdio server for this application.",
+				entry: {
+					file: (0, _stryke_path_join.joinPaths)(this.entryPath, "mcp", "index.ts"),
+					input: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "mcp", "command.ts") },
+					...commandEntry ?? {}
+				},
+				virtual: false
+			};
+			this.inputs.push(mcpCommand);
+			await (0, _shell_shock_core_helpers_power_plant.executeCommandGenerator)(this, require_generator.default, { template: (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_mcp_command.McpCommandModule, {
+				get appName() {
+					return _self$.config.name;
+				},
+				get commandName() {
+					return _self$.config.mcp.command.name;
+				},
+				get commands() {
+					return Object.values(_self$.commands);
+				}
+			}) });
+		},
+		prepare: {
+			order: "post",
+			async handler() {
+				this.debug("Generating the Shell Shock MCP command module via Power Plant from resolved commands.");
+				await (0, _shell_shock_core_helpers_power_plant.executeCommandGenerator)(this, require_generator.default);
+			}
+		}
+	};
+};
+
+//#endregion
+exports.default = plugin;
+exports.plugin = plugin;
+exports.mcpGenerator = require_generator.default;

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import mcpGenerator from "./generator.cjs";
+import { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig } from "./types/plugin.cjs";
+import "./types/index.cjs";
+import { Plugin } from "powerlines";
+//#region src/index.d.ts
+/**
+ * A Shell Shock plugin that generates an MCP server command from the resolved command tree.
+ */
+declare const plugin: <TContext extends McpPluginContext = McpPluginContext>(options?: McpPluginOptions) => Plugin<TContext>;
+//#endregion
+export { type McpPluginContext, type McpPluginOptions, type McpPluginResolvedConfig, type McpPluginUserConfig, plugin as default, plugin, mcpGenerator };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;;;cAkCa,SAAU,iBAAiB,mBAAmB,kBACzD,UAAS,qBACR,OAAO"}

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+import mcpGenerator from "./generator.mjs";
+import { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig } from "./types/plugin.mjs";
+import "./types/index.mjs";
+import { Plugin } from "powerlines";
+//#region src/index.d.ts
+/**
+ * A Shell Shock plugin that generates an MCP server command from the resolved command tree.
+ */
+declare const plugin: <TContext extends McpPluginContext = McpPluginContext>(options?: McpPluginOptions) => Plugin<TContext>;
+//#endregion
+export { type McpPluginContext, type McpPluginOptions, type McpPluginResolvedConfig, type McpPluginUserConfig, plugin as default, plugin, mcpGenerator };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":""}

package/dist/index.mjs

@@ -0,0 +1,77 @@
+import { McpCommandModule } from "./components/mcp-command.mjs";
+import mcpGenerator from "./generator.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { executeCommandGenerator } from "@shell-shock/core/helpers/power-plant";
+import { joinPaths } from "@stryke/path/join";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { defu } from "defu";
+
+//#region src/index.tsx
+/**
+* A Shell Shock plugin that generates an MCP server command from the resolved command tree.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock/mcp",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `mcp` plugin.");
+			const commandName = isSetString(options.command) ? options.command : null;
+			const commandConfig = typeof options.command === "object" && options.command ? options.command : {};
+			return { mcp: defu({ command: { name: commandName ?? commandConfig.name ?? "mcp" } }, {
+				...options,
+				command: commandConfig
+			}) };
+		},
+		async configResolved() {
+			const _self$ = this;
+			this.debug("Adding the CLI mcp command to the application context.");
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === this.config.mcp.command.name)) {
+				this.info("The `mcp` command already exists in the commands list. If you would like the mcp command to be managed by the `@shell-shock/plugin-mcp` package, please remove or rename the command.");
+				return;
+			}
+			const { entry: commandEntry, ...commandOverrides } = this.config.mcp.command;
+			const mcpCommand = {
+				...commandOverrides,
+				id: this.config.mcp.command.name,
+				name: this.config.mcp.command.name,
+				path: this.config.mcp.command.name,
+				segments: [this.config.mcp.command.name],
+				title: "Model Context Protocol (MCP) Server",
+				icon: "🔌",
+				alias: [],
+				tags: ["AI"],
+				description: "Start a Model Context Protocol (MCP) stdio server for this application.",
+				entry: {
+					file: joinPaths(this.entryPath, "mcp", "index.ts"),
+					input: { file: joinPaths(this.entryPath, "mcp", "command.ts") },
+					...commandEntry ?? {}
+				},
+				virtual: false
+			};
+			this.inputs.push(mcpCommand);
+			await executeCommandGenerator(this, mcpGenerator, { template: createComponent(McpCommandModule, {
+				get appName() {
+					return _self$.config.name;
+				},
+				get commandName() {
+					return _self$.config.mcp.command.name;
+				},
+				get commands() {
+					return Object.values(_self$.commands);
+				}
+			}) });
+		},
+		prepare: {
+			order: "post",
+			async handler() {
+				this.debug("Generating the Shell Shock MCP command module via Power Plant from resolved commands.");
+				await executeCommandGenerator(this, mcpGenerator);
+			}
+		}
+	};
+};
+
+//#endregion
+export { plugin as default, plugin, mcpGenerator };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":[],"mappings":""}

package/dist/types/index.cjs

@@ -0,0 +1 @@
+require('./plugin.cjs');

package/dist/types/index.d.cts

@@ -0,0 +1,2 @@
+import { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig } from "./plugin.cjs";
+export { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig };

package/dist/types/index.d.mts

@@ -0,0 +1,2 @@
+import { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig } from "./plugin.mjs";
+export { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig };

package/dist/types/index.mjs

@@ -0,0 +1,3 @@
+import "./plugin.mjs";
+
+export {  };

package/dist/types/plugin.d.cts

@@ -0,0 +1,21 @@
+import { CommandConfig, Context, ResolvedConfig, UserConfig } from "@shell-shock/core";
+import { RequiredKeys } from "@stryke/types/base";
+//#region src/types/plugin.d.ts
+interface McpPluginOptions {
+  /**
+   * The command name used to expose the MCP server.
+   */
+  command?: Partial<CommandConfig> | string;
+}
+type McpPluginUserConfig = UserConfig & {
+  mcp: McpPluginOptions;
+};
+type McpPluginResolvedConfig = ResolvedConfig & {
+  mcp: {
+    command: RequiredKeys<Partial<CommandConfig>, "name">;
+  };
+};
+type McpPluginContext<TResolvedConfig extends McpPluginResolvedConfig = McpPluginResolvedConfig> = Context<TResolvedConfig>;
+//#endregion
+export { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;UA0BiB;;;;EAIf,UAAU,QAAQ;;KAGR,sBAAsB;EAChC,KAAK;;KAGK,0BAA0B;EACpC;IACE,SAAS,aAAa,QAAQ;;;KAItB,iBACV,wBAAwB,0BAA0B,2BAChD,QAAQ"}

package/dist/types/plugin.d.mts

@@ -0,0 +1,21 @@
+import { CommandConfig, Context, ResolvedConfig, UserConfig } from "@shell-shock/core";
+import { RequiredKeys } from "@stryke/types/base";
+//#region src/types/plugin.d.ts
+interface McpPluginOptions {
+  /**
+   * The command name used to expose the MCP server.
+   */
+  command?: Partial<CommandConfig> | string;
+}
+type McpPluginUserConfig = UserConfig & {
+  mcp: McpPluginOptions;
+};
+type McpPluginResolvedConfig = ResolvedConfig & {
+  mcp: {
+    command: RequiredKeys<Partial<CommandConfig>, "name">;
+  };
+};
+type McpPluginContext<TResolvedConfig extends McpPluginResolvedConfig = McpPluginResolvedConfig> = Context<TResolvedConfig>;
+//#endregion
+export { McpPluginContext, McpPluginOptions, McpPluginResolvedConfig, McpPluginUserConfig };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

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

package/dist/types/plugin.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "@shell-shock/plugin-mcp",
+  "version": "0.1.1",
+  "private": false,
+  "description": "A package containing a Shell Shock plugin to expose CLI commands through an MCP server.",
+  "keywords": [
+    "shell-shock",
+    "shell-shock-plugin",
+    "mcp",
+    "powerlines",
+    "storm-software"
+  ],
+  "homepage": "https://stormsoftware.com",
+  "bugs": {
+    "url": "https://stormsoftware.com/support",
+    "email": "support@stormsoftware.com"
+  },
+  "repository": {
+    "type": "github",
+    "url": "https://github.com/storm-software/shell-shock.git",
+    "directory": "packages/plugin-mcp"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/storm-software"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "Storm Software",
+    "email": "contact@stormsoftware.com",
+    "url": "https://stormsoftware.com"
+  },
+  "maintainers": [
+    {
+      "name": "Storm Software",
+      "email": "contact@stormsoftware.com",
+      "url": "https://stormsoftware.com"
+    }
+  ],
+  "contributors": [
+    {
+      "name": "Storm Software",
+      "email": "contact@stormsoftware.com",
+      "url": "https://stormsoftware.com"
+    }
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "default": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./components/mcp-command": {
+      "require": {
+        "types": "./dist/components/mcp-command.d.cts",
+        "default": "./dist/components/mcp-command.cjs"
+      },
+      "import": {
+        "types": "./dist/components/mcp-command.d.mts",
+        "default": "./dist/components/mcp-command.mjs"
+      },
+      "default": {
+        "types": "./dist/components/mcp-command.d.mts",
+        "default": "./dist/components/mcp-command.mjs"
+      }
+    },
+    "./generator": {
+      "require": {
+        "types": "./dist/generator.d.cts",
+        "default": "./dist/generator.cjs"
+      },
+      "import": {
+        "types": "./dist/generator.d.mts",
+        "default": "./dist/generator.mjs"
+      },
+      "default": {
+        "types": "./dist/generator.d.mts",
+        "default": "./dist/generator.mjs"
+      }
+    },
+    "./package.json": "./package.json",
+    "./types": {
+      "require": {
+        "types": "./dist/types/index.d.cts",
+        "default": "./dist/types/index.cjs"
+      },
+      "import": {
+        "types": "./dist/types/index.d.mts",
+        "default": "./dist/types/index.mjs"
+      },
+      "default": {
+        "types": "./dist/types/index.d.mts",
+        "default": "./dist/types/index.mjs"
+      }
+    },
+    "./types/plugin": {
+      "require": {
+        "types": "./dist/types/plugin.d.cts",
+        "default": "./dist/types/plugin.cjs"
+      },
+      "import": {
+        "types": "./dist/types/plugin.d.mts",
+        "default": "./dist/types/plugin.mjs"
+      },
+      "default": {
+        "types": "./dist/types/plugin.d.mts",
+        "default": "./dist/types/plugin.mjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "typings": "dist/index.d.mts",
+  "files": ["dist"],
+  "dependencies": {
+    "@alloy-js/core": "^0.24.1",
+    "@alloy-js/typescript": "^0.24.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "@power-plant/alloy-js": "^0.0.87",
+    "@power-plant/core": "^0.0.90",
+    "@powerlines/plugin-alloy": "^0.26.308",
+    "@powerlines/plugin-plugin": "^0.12.623",
+    "@shell-shock/core": "0.17.23",
+    "@stryke/path": "^0.29.35",
+    "@stryke/type-checks": "^0.6.41",
+    "defu": "^6.1.7",
+    "powerlines": "^0.47.210",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": { "@types/node": "^25.9.5" },
+  "publishConfig": { "access": "public" },
+  "gitHead": "3227e8ed7b3e816987d4d4f270dfdfceb963c022"
+}