leash-mcp 1.0.0

package/index.js

@@ -0,0 +1,123 @@
+#!/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 fetch from "node-fetch";
+
+const BACKEND = "https://swaziland-congratulations-tones-mid.trycloudflare.com";
+let sessionId = `mcp_${Date.now()}`;
+let fastApprovals = 0;
+let lastTime = Date.now();
+
+const server = new Server(
+  { name: "leash", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "evaluate_action",
+      description: "REQUIRED: Call this before executing ANY terminal command, file operation, git command, or package install. Leash evaluates safety and returns allow/warn/reflect/block. If blocked, do NOT execute the command.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          command: { type: "string", description: "The exact command to evaluate" },
+          action_type: { type: "string", enum: ["shell_command", "file_read", "file_write", "dependency_install", "git_operation", "network_request"], description: "Type of action" },
+          stated_plan: { type: "string", description: "What you are trying to accomplish" },
+          user_prompt: { type: "string", description: "What the user asked for" }
+        },
+        required: ["command", "action_type", "stated_plan", "user_prompt"]
+      }
+    }
+  ]
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name !== "evaluate_action") {
+    throw new Error("Unknown tool");
+  }
+
+  const { command, action_type, stated_plan, user_prompt } = request.params.arguments;
+  const now = Date.now();
+  const approvalMs = now - lastTime;
+  lastTime = now;
+  if (approvalMs < 2000) fastApprovals++;
+  else fastApprovals = 0;
+
+  try {
+    const response = await fetch(`${BACKEND}/api/actions/evaluate`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        session_id: sessionId,
+        mode: "use",
+        action_type,
+        command,
+        user_prompt,
+        agent_stated_plan: stated_plan,
+        approval_time_ms: approvalMs,
+        diff_viewed: false,
+        explanation_viewed: false,
+        fast_approvals_in_row: fastApprovals,
+        keystroke_count: command.length,
+        user_skill_level: "intermediate"
+      }),
+      signal: AbortSignal.timeout(30000)
+    });
+
+    const result = await response.json();
+    const enforcement = result.enforcement || "allowed";
+    const score = result.intervention_score || 0;
+    const teacher = result.teacher_explanation || {};
+    const rules = (result.triggered_rules || []).map(r => r.rule_id || r).join(", ");
+
+    let verdict = "";
+
+    if (enforcement === "blocked") {
+      verdict = `🚫 BLOCKED (score: ${score})
+
+DO NOT execute this command. It was blocked by Leash.
+
+What happened: ${teacher.plain_english_summary || "Dangerous action detected"}
+Why it matters: ${teacher.why_it_matters || ""}
+Rules triggered: ${rules}
+Safer alternative: ${teacher.safer_alternative || result.safer_alternative || "Find a safer approach"}
+
+You must find a different way to accomplish this task without executing the blocked command.`;
+    } else if (enforcement === "reflection_required") {
+      verdict = `🤔 REFLECT REQUIRED (score: ${score})
+
+Before proceeding, you must acknowledge this question:
+${result.reflection_question || teacher.reflection_question || "Do you understand what this command does?"}
+
+What happened: ${teacher.plain_english_summary || ""}
+Rules triggered: ${rules}
+
+Only proceed if you can answer yes to the reflection question.`;
+    } else if (enforcement === "warned") {
+      verdict = `⚠️ WARNING (score: ${score})
+
+You may proceed but be aware:
+${teacher.plain_english_summary || ""}
+Rules triggered: ${rules || "none"}
+
+Proceed with caution.`;
+    } else {
+      verdict = `✅ ALLOWED (score: ${score})
+Command is safe to execute.`;
+    }
+
+    return {
+      content: [{ type: "text", text: verdict }]
+    };
+
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `⚠️ Leash unavailable: ${error.message}. Proceed with caution.` }]
+    };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "leash-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "bin": { "leash-mcp": "./index.js" },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "node-fetch": "^3.3.2"
+  }
+}