@viberaven/mcp 1.1.5 → 1.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VibeRaven
+
+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

@@ -32,6 +32,8 @@ npx -y viberaven mcp
 - `viberaven_strict_gate` -> `npx -y viberaven --agent-mode --strict --json`
 - `viberaven_gate_result` -> `npx -y viberaven --agent-mode --json`
 - `viberaven_context_map` -> `npx -y viberaven --condense`
+- `viberaven_actions` -> `npx -y viberaven actions`
+- `viberaven_verify_action` -> `npx -y viberaven verify --action <id>`
 - `viberaven_heal_plan` -> `npx -y viberaven --heal --plan`
 - `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
 - `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`

package/bin/server.js

@@ -2,7 +2,7 @@
 const { spawn } = require('node:child_process');
 let spawnChild = spawn;
 
-const SERVER_INFO = { name: 'viberaven-mcp', version: '1.1.5' };
+const SERVER_INFO = { name: 'viberaven-mcp', version: '1.1.7' };
 const CLI_PACKAGE = '@viberaven/cli';
 
 const cwdSchema = {
@@ -80,6 +80,24 @@ const TOOLS = [
     description: 'Refresh .viberaven/context-map.json from the last scan.',
     inputSchema: cwdSchema
   },
+  {
+    name: 'viberaven_actions',
+    description: 'Read the current VibeRaven chat-native action surface from .viberaven/actions.json.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_verify_action',
+    description: 'Verify or explain the lifecycle state for a stable VibeRaven action ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string' },
+        actionId: { type: 'string' }
+      },
+      required: ['actionId'],
+      additionalProperties: false
+    }
+  },
   {
     name: 'viberaven_heal_plan',
     description: 'Write a non-destructive VibeRaven heal plan for a target file or gap.',
@@ -237,6 +255,12 @@ function buildToolArgs(name, args) {
   if (name === 'viberaven_context_map') {
     return ['--condense'];
   }
+  if (name === 'viberaven_actions') {
+    return ['actions'];
+  }
+  if (name === 'viberaven_verify_action') {
+    return ['--verify', '--action', safeStringArg(args.actionId, 'actionId')];
+  }
   if (name === 'viberaven_heal_plan') {
     return buildHealArgs(['--heal', '--plan'], args);
   }

package/bin/viberaven-mcp.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+const readline = require('node:readline');
+
+const serverInfo = {
+  name: 'viberaven-mcp',
+  version: '0.1.0-beta.0',
+};
+
+const tools = [
+  {
+    name: 'viberaven_scan',
+    description: 'Scan an AI-built app for launch-readiness gaps and write .viberaven artifacts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Workspace directory to scan. Defaults to the MCP process cwd.' },
+        json: { type: 'boolean', description: 'Return CLI JSON output when supported.' },
+      },
+    },
+  },
+  {
+    name: 'viberaven_next',
+    description: 'Return the next recommended launch-readiness action from the last scan.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Workspace directory. Defaults to the MCP process cwd.' },
+      },
+    },
+  },
+  {
+    name: 'viberaven_prompt',
+    description: 'Return a copy-ready coding-agent prompt for a launch gap.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Workspace directory. Defaults to the MCP process cwd.' },
+        gap: { type: 'string', description: 'Gap id from .viberaven/last-scan.json or viberaven_next.' },
+        area: { type: 'string', description: 'Optional production area such as auth, database, payments, deployment.' },
+        provider: { type: 'string', description: 'Optional provider such as clerk, supabase, stripe, vercel.' },
+      },
+    },
+  },
+  {
+    name: 'viberaven_status',
+    description: 'Return VibeRaven account and scan quota status.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Workspace directory. Defaults to the MCP process cwd.' },
+      },
+    },
+  },
+  {
+    name: 'viberaven_report',
+    description: 'Rebuild .viberaven/report.html from the last scan without consuming scan quota.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Workspace directory. Defaults to the MCP process cwd.' },
+      },
+    },
+  },
+];
+
+function write(message) {
+  process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+
+function runCli(args, cwd) {
+  return new Promise((resolve) => {
+    const child = spawn('npx', ['-y', '@viberaven/cli@beta', ...args], {
+      cwd: cwd || process.cwd(),
+      shell: process.platform === 'win32',
+      env: process.env,
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on('close', (code) => {
+      resolve({ code, stdout, stderr });
+    });
+  });
+}
+
+function textResult(text, isError = false) {
+  return {
+    content: [{ type: 'text', text: text || '(no output)' }],
+    isError,
+  };
+}
+
+async function callTool(name, input = {}) {
+  const cwd = typeof input.cwd === 'string' && input.cwd.trim() ? input.cwd : undefined;
+  if (name === 'viberaven_scan') {
+    const args = ['scan'];
+    if (input.json) args.push('--json');
+    const result = await runCli(args, cwd);
+    return textResult(`${result.stdout}${result.stderr ? `\n${result.stderr}` : ''}`.trim(), result.code !== 0);
+  }
+  if (name === 'viberaven_next') {
+    const result = await runCli(['next', '--json'], cwd);
+    return textResult(`${result.stdout}${result.stderr ? `\n${result.stderr}` : ''}`.trim(), result.code !== 0);
+  }
+  if (name === 'viberaven_prompt') {
+    const args = ['prompt', '--no-copy'];
+    if (input.gap) args.push('--gap', String(input.gap));
+    if (input.area) args.push('--area', String(input.area));
+    if (input.provider) args.push('--provider', String(input.provider));
+    const result = await runCli(args, cwd);
+    return textResult(`${result.stdout}${result.stderr ? `\n${result.stderr}` : ''}`.trim(), result.code !== 0);
+  }
+  if (name === 'viberaven_status') {
+    const result = await runCli(['status', '--json'], cwd);
+    return textResult(`${result.stdout}${result.stderr ? `\n${result.stderr}` : ''}`.trim(), result.code !== 0);
+  }
+  if (name === 'viberaven_report') {
+    const result = await runCli(['report'], cwd);
+    return textResult(`${result.stdout}${result.stderr ? `\n${result.stderr}` : ''}`.trim(), result.code !== 0);
+  }
+  return textResult(`Unknown VibeRaven MCP tool: ${name}`, true);
+}
+
+const rl = readline.createInterface({ input: process.stdin });
+
+rl.on('line', async (line) => {
+  if (!line.trim()) return;
+  let request;
+  try {
+    request = JSON.parse(line);
+  } catch {
+    return;
+  }
+
+  if (request.method === 'initialize') {
+    write({
+      jsonrpc: '2.0',
+      id: request.id,
+      result: {
+        protocolVersion: '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo,
+      },
+    });
+    return;
+  }
+
+  if (request.method === 'notifications/initialized') {
+    return;
+  }
+
+  if (request.method === 'tools/list') {
+    write({ jsonrpc: '2.0', id: request.id, result: { tools } });
+    return;
+  }
+
+  if (request.method === 'tools/call') {
+    const params = request.params || {};
+    const result = await callTool(params.name, params.arguments || {});
+    write({ jsonrpc: '2.0', id: request.id, result });
+    return;
+  }
+
+  write({
+    jsonrpc: '2.0',
+    id: request.id,
+    error: { code: -32601, message: `Method not found: ${request.method}` },
+  });
+});

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@viberaven/mcp",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "MCP server for VibeRaven production-readiness: check_readiness, verify, heal, audit, and strict gate tools for Cursor, Claude Code, and Codex.",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "author": "VibeRaven",
   "mcpName": "io.github.ohad6k/viberaven",
   "homepage": "https://viberaven.dev/mcp.md",