par5-mcp 0.1.0 → 0.1.2

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-	".": "0.1.0"
+	".": "0.1.2"
 }

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.1.2](https://github.com/jrandolf/par5-mcp/compare/v0.1.1...v0.1.2) (2025-12-30)
+
+
+### Features
+
+* add process cleanup on shutdown to manage active child processes ([68cbbbe](https://github.com/jrandolf/par5-mcp/commit/68cbbbec5188d9caba55bf17f8aa6a022e70cc17))
+
+## [0.1.1](https://github.com/jrandolf/par5-mcp/compare/v0.1.0...v0.1.1) (2025-12-30)
+
+
+### Features
+
+* implement diceware list names and create_list_from_shell ([5e3e0ff](https://github.com/jrandolf/par5-mcp/commit/5e3e0ff9cbdce32a7d399f9eea8a7bd36b7d876f))
+
 ## 0.1.0 (2025-12-30)
 
 

package/dist/index.js

@@ -6,7 +6,31 @@ import { tmpdir } from "node:os";
 import { basename, join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import generatePassphrase from "eff-diceware-passphrase";
 import { z } from "zod";
+// Track all active child processes for cleanup on shutdown
+const activeProcesses = new Set();
+// Cleanup function to kill all active child processes
+function cleanupProcesses() {
+    for (const child of activeProcesses) {
+        if (!child.killed) {
+            child.kill("SIGTERM");
+        }
+    }
+    activeProcesses.clear();
+}
+// Register shutdown handlers
+process.on("SIGTERM", () => {
+    cleanupProcesses();
+    process.exit(0);
+});
+process.on("SIGINT", () => {
+    cleanupProcesses();
+    process.exit(0);
+});
+process.on("exit", () => {
+    cleanupProcesses();
+});
 // Helper to create a safe filename from an item string
 function toSafeFilename(item) {
     // Get basename if it's a path
@@ -28,6 +52,8 @@ function runCommandToFiles(command, stdoutFile, stderrFile, options = {}) {
             const child = spawn("sh", ["-c", command], {
                 stdio: ["ignore", "pipe", "pipe"],
             });
+            // Track the child process for cleanup on shutdown
+            activeProcesses.add(child);
             let timeoutId;
             if (options.timeout) {
                 timeoutId = setTimeout(() => {
@@ -37,6 +63,7 @@ function runCommandToFiles(command, stdoutFile, stderrFile, options = {}) {
             child.stdout.pipe(stdoutStream);
             child.stderr.pipe(stderrStream);
             child.on("close", async () => {
+                activeProcesses.delete(child);
                 if (timeoutId)
                     clearTimeout(timeoutId);
                 stdoutStream.end();
@@ -46,6 +73,7 @@ function runCommandToFiles(command, stdoutFile, stderrFile, options = {}) {
                 resolve();
             });
             child.on("error", async (err) => {
+                activeProcesses.delete(child);
                 if (timeoutId)
                     clearTimeout(timeoutId);
                 stderrStream.write(`\nERROR: ${err.message}\n`);
@@ -71,6 +99,17 @@ async function runInBatches(tasks) {
 const outputDir = join(tmpdir(), "par5-mcp-results");
 // Store for lists
 const lists = new Map();
+// Generate a unique diceware list ID (3 words joined with hyphens)
+function generateListId() {
+    const words = generatePassphrase(3);
+    let id = words.join("-");
+    // Ensure uniqueness by appending more words if needed
+    while (lists.has(id)) {
+        const extraWord = generatePassphrase(1)[0];
+        id = `${id}-${extraWord}`;
+    }
+    return id;
+}
 // Create the MCP server
 const server = new McpServer({
     name: "par5-mcp",
@@ -96,7 +135,7 @@ EXAMPLE: To process files ["src/a.ts", "src/b.ts", "src/c.ts"], first create a l
             .describe("Array of items to store in the list. Each item can be a file path, URL, identifier, or any string that will be substituted into commands or prompts."),
     },
 }, async ({ items }) => {
-    const id = randomUUID();
+    const id = generateListId();
     lists.set(id, items);
     return {
         content: [
@@ -107,6 +146,101 @@ EXAMPLE: To process files ["src/a.ts", "src/b.ts", "src/c.ts"], first create a l
         ],
     };
 });
+// Tool: create_list_from_shell
+server.registerTool("create_list_from_shell", {
+    description: `Creates a list by running a shell command and parsing its newline-delimited output.
+
+WHEN TO USE:
+- When you need to create a list from command output (e.g., find, ls, grep, git ls-files)
+- When the list of items to process is determined by a shell command
+- As an alternative to manually specifying items in create_list
+
+EXAMPLES:
+- "find src -name '*.ts'" to get all TypeScript files
+- "git ls-files '*.tsx'" to get all tracked TSX files
+- "ls *.json" to get all JSON files in current directory
+- "grep -l 'TODO' src/**/*.ts" to get files containing TODO
+
+WORKFLOW:
+1. Call create_list_from_shell with your command
+2. The command's stdout is split by newlines to create list items
+3. Empty lines are filtered out
+4. Use the returned list_id with run_shell_across_list or run_agent_across_list`,
+    inputSchema: {
+        command: z
+            .string()
+            .describe("Shell command to run. Its stdout will be split by newlines to create list items. Example: 'find src -name \"*.ts\"' or 'git ls-files'"),
+    },
+}, async ({ command }) => {
+    return new Promise((resolve) => {
+        const child = spawn("sh", ["-c", command], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        // Track the child process for cleanup on shutdown
+        activeProcesses.add(child);
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("close", (code) => {
+            activeProcesses.delete(child);
+            if (code !== 0 && stderr) {
+                resolve({
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Command exited with code ${code}.\n\nstderr:\n${stderr}`,
+                        },
+                    ],
+                    isError: true,
+                });
+                return;
+            }
+            // Split by newlines and filter out empty lines
+            const items = stdout
+                .split("\n")
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0);
+            if (items.length === 0) {
+                resolve({
+                    content: [
+                        {
+                            type: "text",
+                            text: `Warning: Command produced no output. No list was created.${stderr ? `\n\nstderr:\n${stderr}` : ""}`,
+                        },
+                    ],
+                });
+                return;
+            }
+            const id = generateListId();
+            lists.set(id, items);
+            resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Successfully created a list with ${items.length} items from command output. The list ID is "${id}". You can now use this ID with run_shell_across_list or run_agent_across_list to process each item in parallel.${stderr ? `\n\nNote: Command produced stderr output:\n${stderr}` : ""}`,
+                    },
+                ],
+            });
+        });
+        child.on("error", (err) => {
+            activeProcesses.delete(child);
+            resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Failed to execute command: ${err.message}`,
+                    },
+                ],
+                isError: true,
+            });
+        });
+    });
+});
 // Tool: get_list
 server.registerTool("get_list", {
     description: `Retrieves the items in an existing list by its ID.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "par5-mcp",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "MCP server for parallel list operations - run shell commands and AI agents across lists in parallel",
 	"main": "dist/index.js",
 	"bin": {
@@ -39,6 +39,8 @@
 	"type": "module",
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "^1.25.1",
+		"@types/eff-diceware-passphrase": "^3.0.2",
+		"eff-diceware-passphrase": "^3.0.0",
 		"zod": "^4.2.1"
 	},
 	"devDependencies": {