loopuman-mcp 1.0.0

package/index.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * Loopuman MCP Server
+ * Gives Claude native access to human workers
+ * 
+ * Usage:
+ * 1. npm install -g loopuman-mcp
+ * 2. Add to Claude config:
+ *    {
+ *      "mcpServers": {
+ *        "loopuman": {
+ *          "command": "loopuman-mcp",
+ *          "env": { "LOOPUMAN_API_KEY": "your_key" }
+ *        }
+ *      }
+ *    }
+ * 3. Ask Claude: "Ask a human if this text is offensive"
+ */
+
+const API_BASE = process.env.LOOPUMAN_API_URL || 'https://api.loopuman.com';
+const API_KEY = process.env.LOOPUMAN_API_KEY;
+
+// MCP Protocol implementation
+const tools = [
+  {
+    name: "ask_human",
+    description: "Ask a human worker to complete a task. Use for verification, judgment, subjective evaluation, or real-world actions. Returns the human's response.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        question: {
+          type: "string",
+          description: "The question or task for the human"
+        },
+        context: {
+          type: "string", 
+          description: "Additional context to help the human understand"
+        },
+        budget_cents: {
+          type: "number",
+          description: "Payment in cents (minimum 10, typical 25-100)",
+          default: 50
+        },
+        timeout_seconds: {
+          type: "number",
+          description: "Max time to wait for response",
+          default: 300
+        }
+      },
+      required: ["question"]
+    }
+  },
+  {
+    name: "human_verification",
+    description: "Get multiple humans to verify something and return consensus",
+    inputSchema: {
+      type: "object",
+      properties: {
+        content: {
+          type: "string",
+          description: "Content to verify"
+        },
+        question: {
+          type: "string",
+          description: "Verification question (e.g., 'Is this accurate?')"
+        },
+        num_workers: {
+          type: "number",
+          description: "Number of humans to ask (3-9)",
+          default: 3
+        }
+      },
+      required: ["content", "question"]
+    }
+  }
+];
+
+async function callLoopuman(title, description, budget, timeout) {
+  const response = await fetch(`${API_BASE}/api/v1/tasks/sync`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-API-Key': API_KEY
+    },
+    body: JSON.stringify({
+      title,
+      description,
+      budget,
+      timeout_seconds: timeout,
+      auto_approve: true
+    })
+  });
+  return response.json();
+}
+
+async function handleToolCall(name, args) {
+  switch (name) {
+    case 'ask_human': {
+      const result = await callLoopuman(
+        args.question,
+        args.context || '',
+        args.budget_cents || 50,
+        args.timeout_seconds || 300
+      );
+      if (result.status === 'completed') {
+        return { response: result.response, worker_id: result.worker_id };
+      }
+      return { error: 'No human responded in time', task_id: result.task_id };
+    }
+    
+    case 'human_verification': {
+      // Create multiple tasks and aggregate
+      const results = [];
+      for (let i = 0; i < (args.num_workers || 3); i++) {
+        const result = await callLoopuman(
+          `Verify: ${args.question}`,
+          `Content to verify:\n${args.content}`,
+          30,
+          300
+        );
+        if (result.status === 'completed') {
+          results.push(result.response);
+        }
+      }
+      return {
+        responses: results,
+        consensus: results.length > 0 ? mostCommon(results) : null
+      };
+    }
+    
+    default:
+      return { error: `Unknown tool: ${name}` };
+  }
+}
+
+function mostCommon(arr) {
+  const counts = {};
+  arr.forEach(x => counts[x] = (counts[x] || 0) + 1);
+  return Object.entries(counts).sort((a,b) => b[1] - a[1])[0]?.[0];
+}
+
+// MCP stdio protocol
+const readline = require('readline');
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+
+process.stdout.write(JSON.stringify({
+  protocolVersion: '2024-11-05',
+  capabilities: { tools: {} },
+  serverInfo: { name: 'loopuman', version: '1.0.0' }
+}) + '\n');
+
+rl.on('line', async (line) => {
+  try {
+    const msg = JSON.parse(line);
+    
+    if (msg.method === 'tools/list') {
+      process.stdout.write(JSON.stringify({
+        id: msg.id,
+        result: { tools }
+      }) + '\n');
+    }
+    
+    if (msg.method === 'tools/call') {
+      const result = await handleToolCall(msg.params.name, msg.params.arguments);
+      process.stdout.write(JSON.stringify({
+        id: msg.id,
+        result: { content: [{ type: 'text', text: JSON.stringify(result) }] }
+      }) + '\n');
+    }
+  } catch (e) {
+    console.error('Error:', e);
+  }
+});

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "loopuman-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Loopuman - Give Claude access to humans",
+  "main": "index.js",
+  "bin": {
+    "loopuman-mcp": "./index.js"
+  },
+  "keywords": ["mcp", "claude", "anthropic", "human-in-the-loop", "loopuman"],
+  "author": "Loopuman",
+  "license": "MIT"
+}