@viberaven/mcp 0.1.0-beta.1

package/README.md

@@ -0,0 +1,23 @@
+# @viberaven/mcp
+
+Thin MCP wrapper for VibeRaven.
+
+This package exposes VibeRaven CLI actions as MCP tools for Codex, Claude Code, Cursor, and other agent runtimes. It does not contain VibeRaven backend logic and does not bypass VibeRaven login or scan quotas.
+
+## Run
+
+```bash
+npx -y @viberaven/mcp@beta
+```
+
+## Tools
+
+- `viberaven_scan` -> `npx -y @viberaven/cli@beta scan`
+- `viberaven_status` -> `npx -y @viberaven/cli@beta status`
+- `viberaven_next` -> `npx -y @viberaven/cli@beta next --json`
+- `viberaven_prompt` -> `npx -y @viberaven/cli@beta prompt`
+- `viberaven_login` -> `npx -y @viberaven/cli@beta login`
+
+## Security
+
+The MCP package is public integration glue only. The CLI still calls the managed VibeRaven API after user login. Free and Pro quota rules still apply.

package/bin/server.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+
+const SERVER_INFO = { name: 'viberaven-mcp', version: '0.1.0-beta.1' };
+
+const TOOLS = [
+  {
+    name: 'viberaven_scan',
+    description: 'Run VibeRaven launch-readiness scan in a project. Opens VibeRaven login when required.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root to scan. Defaults to the MCP server working directory.' },
+        path: { type: 'string', description: 'Optional path argument passed to viberaven scan.' },
+        open: { type: 'boolean', description: 'Open the generated report after scan.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_status',
+    description: 'Show VibeRaven account, quota, and last scan status.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root. Defaults to the MCP server working directory.' },
+        json: { type: 'boolean', description: 'Return machine-readable status JSON.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_next',
+    description: 'Return the next VibeRaven production action from the last scan.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root. Defaults to the MCP server working directory.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_prompt',
+    description: 'Return the focused VibeRaven fix prompt for the top or selected gap.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root. Defaults to the MCP server working directory.' },
+        gap: { type: 'string', description: 'Optional gap id.' },
+        area: { type: 'string', description: 'Optional production area.' },
+        provider: { type: 'string', description: 'Optional provider key.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_login',
+    description: 'Start VibeRaven browser sign-in and save local CLI credentials after approval.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Working directory. Defaults to the MCP server working directory.' }
+      },
+      additionalProperties: false
+    }
+  }
+];
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`${SERVER_INFO.name} ${SERVER_INFO.version}`);
+  console.log('MCP stdio server wrapping npx -y @viberaven/cli@beta.');
+  process.exit(0);
+}
+
+let buffer = Buffer.alloc(0);
+
+process.stdin.on('data', (chunk) => {
+  buffer = Buffer.concat([buffer, chunk]);
+  drainMessages();
+});
+
+function drainMessages() {
+  while (true) {
+    const headerEnd = buffer.indexOf('\r\n\r\n');
+    if (headerEnd === -1) return;
+
+    const header = buffer.slice(0, headerEnd).toString('utf8');
+    const match = header.match(/content-length:\s*(\d+)/i);
+    if (!match) {
+      buffer = buffer.slice(headerEnd + 4);
+      continue;
+    }
+
+    const length = Number(match[1]);
+    const messageStart = headerEnd + 4;
+    const messageEnd = messageStart + length;
+    if (buffer.length < messageEnd) return;
+
+    const raw = buffer.slice(messageStart, messageEnd).toString('utf8');
+    buffer = buffer.slice(messageEnd);
+    void handleRawMessage(raw);
+  }
+}
+
+async function handleRawMessage(raw) {
+  let message;
+  try {
+    message = JSON.parse(raw);
+  } catch {
+    return;
+  }
+
+  if (!message || typeof message.method !== 'string') return;
+  if (message.id === undefined || message.id === null) return;
+
+  try {
+    const result = await handleRequest(message.method, message.params || {});
+    send({ jsonrpc: '2.0', id: message.id, result });
+  } catch (error) {
+    send({
+      jsonrpc: '2.0',
+      id: message.id,
+      error: {
+        code: -32000,
+        message: error instanceof Error ? error.message : String(error)
+      }
+    });
+  }
+}
+
+async function handleRequest(method, params) {
+  if (method === 'initialize') {
+    return {
+      protocolVersion: params.protocolVersion || '2024-11-05',
+      capabilities: { tools: {} },
+      serverInfo: SERVER_INFO
+    };
+  }
+
+  if (method === 'tools/list') {
+    return { tools: TOOLS };
+  }
+
+  if (method === 'tools/call') {
+    const name = params.name;
+    const args = params.arguments || {};
+    const text = await callTool(name, args);
+    return { content: [{ type: 'text', text }] };
+  }
+
+  throw new Error(`Unsupported MCP method: ${method}`);
+}
+
+async function callTool(name, args) {
+  if (name === 'viberaven_scan') {
+    return runVibeRaven(['scan', ...(args.open ? ['--open'] : []), ...(args.path ? [String(args.path)] : [])], args.cwd);
+  }
+  if (name === 'viberaven_status') {
+    return runVibeRaven(['status', ...(args.json ? ['--json'] : [])], args.cwd);
+  }
+  if (name === 'viberaven_next') {
+    return runVibeRaven(['next', '--json'], args.cwd);
+  }
+  if (name === 'viberaven_prompt') {
+    const cliArgs = ['prompt'];
+    if (args.gap) cliArgs.push('--gap', String(args.gap));
+    if (args.area) cliArgs.push('--area', String(args.area));
+    if (args.provider) cliArgs.push('--provider', String(args.provider));
+    return runVibeRaven(cliArgs, args.cwd);
+  }
+  if (name === 'viberaven_login') {
+    return runVibeRaven(['login'], args.cwd);
+  }
+  throw new Error(`Unknown VibeRaven tool: ${name}`);
+}
+
+function runVibeRaven(args, cwd) {
+  return new Promise((resolve) => {
+    const child = spawn('npx', ['-y', '@viberaven/cli@beta', ...args], {
+      cwd: typeof cwd === 'string' && cwd.trim() ? cwd : process.cwd(),
+      env: process.env,
+      shell: process.platform === 'win32'
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on('error', (error) => {
+      resolve(`ERROR: ${error.message}`);
+    });
+    child.on('close', (code) => {
+      const combined = `${stdout}${stderr}`.trim();
+      resolve(`exit ${code ?? 1}\n${combined}`);
+    });
+  });
+}
+
+function send(message) {
+  const body = JSON.stringify(message);
+  process.stdout.write(`Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n${body}`);
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@viberaven/mcp",
+  "version": "0.1.0-beta.1",
+  "description": "Thin MCP wrapper around the VibeRaven CLI for agent launch-readiness workflows.",
+  "license": "UNLICENSED",
+  "author": "VibeRaven",
+  "homepage": "https://viberaven.dev/mcp.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ohad6k/VibeRaven.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/ohad6k/VibeRaven/issues"
+  },
+  "keywords": [
+    "viberaven",
+    "mcp",
+    "claude-code",
+    "codex",
+    "cursor",
+    "launch-readiness",
+    "production"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "bin": {
+    "viberaven-mcp": "bin/server.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "smoke": "node scripts/smoke.mjs"
+  }
+}