cli-mcp-mapper 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steffen Blake
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# cli-mcp-mapper

package/index.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { spawn } from "child_process";
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+
+// Load config from env variable or default path
+const defaultConfig = join(homedir(), ".config", "cli-mcp-mapper", "commands.json");
+const configPath = process.env.CLI_MCP_MAPPER_CONFIG || defaultConfig;
+const config = JSON.parse(await readFile(configPath, "utf-8"));
+
+const server = new Server(
+  {
+    name: "cli-mcp-mapper",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: Object.keys(config.commands).reduce((acc, name) => {
+        acc[name] = true;
+        return acc;
+      }, {}),
+    },
+  }
+);
+
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  const tools = Object.entries(config.commands).map(([name, cmd]) => ({
+    name,
+    description: cmd.description,
+    inputSchema: buildInputSchema(cmd.parameters),
+  }));
+  
+  return { tools };
+});
+
+// Execute tool
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const commandConfig = config.commands[name];
+  
+  if (!commandConfig) {
+    throw new Error(`Unknown command: ${name}`);
+  }
+  
+  const cmdArray = buildCommand(commandConfig, args);
+  const result = await executeCommand(cmdArray);
+  
+  return {
+    content: [
+      {
+        type: "text",
+        text: result,
+      },
+    ],
+  };
+});
+
+function buildInputSchema(parameters) {
+  const properties = {};
+  const required = [];
+  
+  for (const [name, param] of Object.entries(parameters || {})) {
+    properties[name] = {
+      type: param.type,
+      description: param.description,
+    };
+    
+    if (param.enum) properties[name].enum = param.enum;
+    if (param.default) properties[name].default = param.default;
+    if (param.required) required.push(name);
+  }
+  
+  return {
+    type: "object",
+    properties,
+    required,
+  };
+}
+
+function buildCommand(commandConfig, args) {
+  const cmd = [commandConfig.command, ...(commandConfig.baseArgs || [])];
+  
+  // Add positional args first
+  const positional = Object.entries(commandConfig.parameters || {})
+    .filter(([_, param]) => param.position !== undefined)
+    .sort(([_, a], [__, b]) => a.position - b.position);
+  
+  for (const [name, param] of positional) {
+    if (args[name] !== undefined) {
+      cmd.push(String(args[name]));
+    }
+  }
+  
+  // Add named args
+  for (const [name, param] of Object.entries(commandConfig.parameters || {})) {
+    if (param.position !== undefined) continue; // Skip positional
+    if (args[name] === undefined) continue; // Skip if not provided
+    
+    if (param.type === "boolean") {
+      if (args[name] === true) {
+        cmd.push(param.argName);
+        if (param.argValue) cmd.push(param.argValue);
+      }
+    } else {
+      cmd.push(param.argName);
+      cmd.push(String(args[name]));
+    }
+  }
+  
+  return cmd;
+}
+
+function executeCommand(cmdArray) {
+  return new Promise((resolve, reject) => {
+    const [command, ...args] = cmdArray;
+    const proc = spawn(command, args, { shell: true });
+    
+    let stdout = "";
+    let stderr = "";
+    
+    proc.stdout.on("data", (data) => (stdout += data));
+    proc.stderr.on("data", (data) => (stderr += data));
+    
+    proc.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error(`Command failed with code ${code}\n${stderr}`));
+      } else {
+        resolve(stdout || stderr);
+      }
+    });
+  });
+}
+
+// Start server
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "cli-mcp-mapper",
+  "version": "1.0.0",
+  "description": "mcp server for mapping cli commands to mcp tools",
+  "homepage": "https://github.com/SteffenBlake/cli-mcp-mapper#readme",
+  "bugs": {
+    "url": "https://github.com/SteffenBlake/cli-mcp-mapper/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SteffenBlake/cli-mcp-mapper.git"
+  },
+  "license": "MIT",
+  "author": "SteffenBlake",
+  "bin": {
+    "cli-mcp-mapper": "./index.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3"
+  }
+}