@viberaven/mcp 1.2.4 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,67 +1,69 @@
1
- # @viberaven/mcp
2
-
3
- [![npm version](https://img.shields.io/npm/v/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
4
- [![npm downloads](https://img.shields.io/npm/dw/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
5
- [![license](https://img.shields.io/npm/l/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
6
-
7
- Thin MCP wrapper for VibeRaven.
8
-
9
- 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.
10
-
1
+ # @viberaven/mcp
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
4
+ [![npm downloads](https://img.shields.io/npm/dw/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
5
+ [![license](https://img.shields.io/npm/l/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
6
+
7
+ Thin MCP wrapper for VibeRaven.
8
+
9
+ 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.
10
+
11
11
  The MCP server wraps the stable CLI package: `npx -y viberaven`.
12
12
 
13
- ## Run
14
-
15
- ```bash
16
- npx -y @viberaven/mcp
17
- ```
18
-
19
- You can also start the MCP server from the main CLI package:
20
-
21
- ```bash
22
- npx -y viberaven mcp
23
- ```
24
-
25
- ## Tools
26
-
27
- - `viberaven_check_readiness` -> `npx -y viberaven --agent-mode`
28
- - `viberaven_verify` -> `npx -y viberaven --verify`
29
- - `viberaven_audit` -> `npx -y viberaven audit --vercel-supabase`
30
- - `viberaven_init_rules` -> `npx -y viberaven init`
31
- - `viberaven_clean_plan` -> `npx -y viberaven clean --plan`
32
- - `viberaven_strict_gate` -> `npx -y viberaven --agent-mode --strict --json`
33
- - `viberaven_gate_result` -> `npx -y viberaven --agent-mode --json`
34
- - `viberaven_context_map` -> `npx -y viberaven --condense`
35
- - `viberaven_actions` -> `npx -y viberaven actions`
36
- - `viberaven_verify_action` -> `npx -y viberaven verify --action <id>`
37
- - `viberaven_heal_plan` -> `npx -y viberaven --heal --plan`
38
- - `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
39
- - `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`
40
- - `viberaven_validate_npm_package` -> `npx -y viberaven validate-npm-package --json`
41
-
42
- `viberaven_check_readiness` is the canonical entrypoint. It runs VibeRaven as the Agent Context + Production Gate and writes `.viberaven/agent-tasklist.md`, `.viberaven/gate-result.json`, and `.viberaven/context-map.json`.
43
-
44
- After one fix, call `viberaven_verify`. Before deploy or CI pass, call `viberaven_strict_gate` or run:
45
-
46
- ```bash
47
- npx -y viberaven --strict
48
- ```
49
-
50
- ## Machine Artifact Contract
51
-
52
- ```text
53
- docs/contracts/artifacts.md
54
- https://viberaven.dev/schemas/gate-result.schema.json
55
- https://viberaven.dev/schemas/context-map.schema.json
56
- https://viberaven.dev/schemas/gap.schema.json
57
- https://viberaven.dev/schemas/heal-result.schema.json
58
- ```
59
-
60
- ## Login
61
-
62
- If VibeRaven prints `LOGIN_URL_READY`, open that exact URL for the user, keep the MCP call alive, and do not ask for passwords, tokens, cookies, or other secrets.
63
-
64
- ## Security
65
-
66
- The MCP package is public integration glue only. It returns CLI stdout/stderr and structured JSON content when available. It does not mutate provider dashboards and does not bypass VibeRaven login, managed API checks, or quota enforcement. Do not claim provider dashboard checks are fixed by repo-code edits.
67
-
13
+ For agent-mode artifacts, use `npx -y viberaven --agent-mode`.
14
+
15
+ ## Run
16
+
17
+ ```bash
18
+ npx -y @viberaven/mcp
19
+ ```
20
+
21
+ You can also start the MCP server from the main CLI package:
22
+
23
+ ```bash
24
+ npx -y viberaven mcp
25
+ ```
26
+
27
+ ## Tools
28
+
29
+ - `viberaven_check_readiness` -> `npx -y viberaven check --json`
30
+ - `viberaven_verify` -> `npx -y viberaven check --json`
31
+ - `viberaven_audit` -> `npx -y viberaven audit --vercel-supabase`
32
+ - `viberaven_init_rules` -> `npx -y viberaven init`
33
+ - `viberaven_clean_plan` -> `npx -y viberaven clean --plan`
34
+ - `viberaven_strict_gate` -> `npx -y viberaven --strict --json`
35
+ - `viberaven_gate_result` -> `npx -y viberaven --json`
36
+ - `viberaven_context_map` -> `npx -y viberaven --condense`
37
+ - `viberaven_actions` -> `npx -y viberaven actions`
38
+ - `viberaven_verify_action` -> `npx -y viberaven verify --action <id>`
39
+ - `viberaven_heal_plan` -> `npx -y viberaven --heal --plan`
40
+ - `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
41
+ - `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`
42
+ - `viberaven_validate_npm_package` -> `npx -y viberaven validate-npm-package --json`
43
+
44
+ `viberaven_check_readiness` is the canonical entrypoint. It runs the local `viberaven check` (no login, no API key, no telemetry) and writes `.viberaven/agent-tasklist.md`, `.viberaven/gate-result.json`, and `.viberaven/context-map.json`.
45
+
46
+ After a batch of fixes, call `viberaven_verify`. Before deploy or CI pass, call `viberaven_strict_gate` or run:
47
+
48
+ ```bash
49
+ npx -y viberaven --strict
50
+ ```
51
+
52
+ ## Machine Artifact Contract
53
+
54
+ ```text
55
+ docs/contracts/artifacts.md
56
+ https://viberaven.dev/schemas/gate-result.schema.json
57
+ https://viberaven.dev/schemas/context-map.schema.json
58
+ https://viberaven.dev/schemas/gap.schema.json
59
+ https://viberaven.dev/schemas/heal-result.schema.json
60
+ ```
61
+
62
+ ## Login
63
+
64
+ If VibeRaven prints `LOGIN_URL_READY`, open that exact URL for the user, keep the MCP call alive, and do not ask for passwords, tokens, cookies, or other secrets.
65
+
66
+ ## Security
67
+
68
+ The MCP package is public integration glue only. It returns CLI stdout/stderr and structured JSON content when available. It does not mutate provider dashboards and does not bypass VibeRaven login, managed API checks, or quota enforcement. Do not claim provider dashboard checks are fixed by repo-code edits.
69
+
@@ -67,9 +67,9 @@ function buildHealArgs(prefix, args) {
67
67
  function buildToolArgs(name, args) {
68
68
  switch (name) {
69
69
  case "viberaven_check_readiness":
70
- return ["--agent-mode"];
70
+ return ["check", "--json"];
71
71
  case "viberaven_verify":
72
- return ["--verify"];
72
+ return ["check", "--json"];
73
73
  case "viberaven_audit":
74
74
  return ["audit", "--vercel-supabase", ...args.json ? ["--json"] : []];
75
75
  case "viberaven_init_rules": {
@@ -81,9 +81,9 @@ function buildToolArgs(name, args) {
81
81
  case "viberaven_clean_plan":
82
82
  return ["clean", "--plan"];
83
83
  case "viberaven_strict_gate":
84
- return ["--agent-mode", "--strict", "--json"];
84
+ return ["--strict", "--json"];
85
85
  case "viberaven_gate_result":
86
- return ["--agent-mode", "--json"];
86
+ return ["--json"];
87
87
  case "viberaven_context_map":
88
88
  return ["--condense"];
89
89
  case "viberaven_actions":
package/dist/server.js CHANGED
@@ -38,12 +38,12 @@ var cwdSchema = {
38
38
  var readinessTools = [
39
39
  {
40
40
  name: "viberaven_check_readiness",
41
- description: "Run BEFORE deploying, shipping to real users, or touching auth, database/RLS, billing, webhooks, or environment variables. Scans the repo for launch blockers (missing RLS, leaked secrets, unbounded queries, unsigned webhooks) and writes a prioritized task list to .viberaven/agent-tasklist.md plus a machine verdict to .viberaven/gate-result.json. Returns the gate status and the single next fix. Calling this first avoids wasted code-generation re-runs by surfacing production risks before you write code.",
41
+ description: "Run BEFORE deploying, shipping to real users, or touching auth, database/RLS, billing, webhooks, or environment variables. Runs the local `viberaven check` (no login, no API key, no telemetry) for launch blockers (missing RLS, leaked secrets, unbounded queries, unsigned webhooks) and writes a prioritized task list to .viberaven/agent-tasklist.md plus a machine verdict to .viberaven/gate-result.json. Calling this first avoids wasted code-generation re-runs by surfacing production risks before you write code.",
42
42
  inputSchema: cwdSchema
43
43
  },
44
44
  {
45
45
  name: "viberaven_verify",
46
- description: "Re-scan and refresh VibeRaven readiness artifacts after you apply one fix. Call this once per batch of fixes (not after every edit) to update .viberaven/gate-result.json and confirm whether the gate moved toward clear.",
46
+ description: "Re-run the local VibeRaven check after you apply fixes. Call this once per batch of fixes (not after every edit) to update .viberaven/gate-result.json and confirm whether the gate moved toward clear.",
47
47
  inputSchema: cwdSchema
48
48
  },
49
49
  {
@@ -204,9 +204,9 @@ function buildHealArgs(prefix, args) {
204
204
  function buildToolArgs(name, args) {
205
205
  switch (name) {
206
206
  case "viberaven_check_readiness":
207
- return ["--agent-mode"];
207
+ return ["check", "--json"];
208
208
  case "viberaven_verify":
209
- return ["--verify"];
209
+ return ["check", "--json"];
210
210
  case "viberaven_audit":
211
211
  return ["audit", "--vercel-supabase", ...args.json ? ["--json"] : []];
212
212
  case "viberaven_init_rules": {
@@ -218,9 +218,9 @@ function buildToolArgs(name, args) {
218
218
  case "viberaven_clean_plan":
219
219
  return ["clean", "--plan"];
220
220
  case "viberaven_strict_gate":
221
- return ["--agent-mode", "--strict", "--json"];
221
+ return ["--strict", "--json"];
222
222
  case "viberaven_gate_result":
223
- return ["--agent-mode", "--json"];
223
+ return ["--json"];
224
224
  case "viberaven_context_map":
225
225
  return ["--condense"];
226
226
  case "viberaven_actions":
@@ -315,7 +315,7 @@ async function handleRequest(method, params) {
315
315
  }
316
316
 
317
317
  // src/server.ts
318
- var SERVER_INFO = { name: "viberaven-mcp", version: "1.2.4" };
318
+ var SERVER_INFO = { name: "viberaven-mcp", version: "1.3.1" };
319
319
  var server = new import_server.Server(SERVER_INFO, { capabilities: { tools: {} } });
320
320
  server.setRequestHandler(
321
321
  import_types.ListToolsRequestSchema,
@@ -39,12 +39,12 @@ var cwdSchema = {
39
39
  var readinessTools = [
40
40
  {
41
41
  name: "viberaven_check_readiness",
42
- description: "Run BEFORE deploying, shipping to real users, or touching auth, database/RLS, billing, webhooks, or environment variables. Scans the repo for launch blockers (missing RLS, leaked secrets, unbounded queries, unsigned webhooks) and writes a prioritized task list to .viberaven/agent-tasklist.md plus a machine verdict to .viberaven/gate-result.json. Returns the gate status and the single next fix. Calling this first avoids wasted code-generation re-runs by surfacing production risks before you write code.",
42
+ description: "Run BEFORE deploying, shipping to real users, or touching auth, database/RLS, billing, webhooks, or environment variables. Runs the local `viberaven check` (no login, no API key, no telemetry) for launch blockers (missing RLS, leaked secrets, unbounded queries, unsigned webhooks) and writes a prioritized task list to .viberaven/agent-tasklist.md plus a machine verdict to .viberaven/gate-result.json. Calling this first avoids wasted code-generation re-runs by surfacing production risks before you write code.",
43
43
  inputSchema: cwdSchema
44
44
  },
45
45
  {
46
46
  name: "viberaven_verify",
47
- description: "Re-scan and refresh VibeRaven readiness artifacts after you apply one fix. Call this once per batch of fixes (not after every edit) to update .viberaven/gate-result.json and confirm whether the gate moved toward clear.",
47
+ description: "Re-run the local VibeRaven check after you apply fixes. Call this once per batch of fixes (not after every edit) to update .viberaven/gate-result.json and confirm whether the gate moved toward clear.",
48
48
  inputSchema: cwdSchema
49
49
  },
50
50
  {
@@ -211,9 +211,9 @@ function buildHealArgs(prefix, args) {
211
211
  function buildToolArgs(name, args) {
212
212
  switch (name) {
213
213
  case "viberaven_check_readiness":
214
- return ["--agent-mode"];
214
+ return ["check", "--json"];
215
215
  case "viberaven_verify":
216
- return ["--verify"];
216
+ return ["check", "--json"];
217
217
  case "viberaven_audit":
218
218
  return ["audit", "--vercel-supabase", ...args.json ? ["--json"] : []];
219
219
  case "viberaven_init_rules": {
@@ -225,9 +225,9 @@ function buildToolArgs(name, args) {
225
225
  case "viberaven_clean_plan":
226
226
  return ["clean", "--plan"];
227
227
  case "viberaven_strict_gate":
228
- return ["--agent-mode", "--strict", "--json"];
228
+ return ["--strict", "--json"];
229
229
  case "viberaven_gate_result":
230
- return ["--agent-mode", "--json"];
230
+ return ["--json"];
231
231
  case "viberaven_context_map":
232
232
  return ["--condense"];
233
233
  case "viberaven_actions":
package/package.json CHANGED
@@ -1,56 +1,56 @@
1
- {
2
- "name": "@viberaven/mcp",
3
- "version": "1.2.4",
4
- "description": "MCP server for VibeRaven production-readiness: check_readiness, verify, heal, audit, and strict gate tools for Cursor, Claude Code, and Codex.",
5
- "license": "MIT",
6
- "author": "VibeRaven",
7
- "mcpName": "io.github.ohad6k/viberaven",
8
- "homepage": "https://viberaven.dev/mcp.md",
9
- "repository": {
10
- "type": "git",
11
- "url": "git+https://github.com/ohad6k/VibeRaven.git",
12
- "directory": "packages/mcp"
13
- },
14
- "bugs": {
15
- "url": "https://github.com/ohad6k/VibeRaven/issues"
16
- },
17
- "keywords": [
18
- "viberaven",
19
- "mcp",
20
- "claude-code",
21
- "codex",
22
- "cursor",
23
- "launch-readiness",
24
- "production"
25
- ],
26
- "publishConfig": {
27
- "access": "public",
28
- "tag": "latest"
29
- },
30
- "bin": {
31
- "viberaven-mcp": "dist/server.js"
32
- },
33
- "files": [
34
- "dist",
35
- "README.md"
36
- ],
37
- "engines": {
38
- "node": ">=20"
39
- },
40
- "scripts": {
41
- "build": "node scripts/build.mjs",
42
- "typecheck": "tsc -p tsconfig.json --noEmit",
43
- "presmoke": "npm run build",
44
- "smoke": "node scripts/smoke.mjs",
45
- "pretest": "npm run build",
46
- "test": "vitest run"
47
- },
48
- "dependencies": {
49
- "@modelcontextprotocol/sdk": "^1.0.0"
50
- },
51
- "devDependencies": {
52
- "esbuild": "^0.25.0",
53
- "typescript": "^5.8.0",
54
- "vitest": "^3.2.0"
55
- }
56
- }
1
+ {
2
+ "name": "@viberaven/mcp",
3
+ "version": "1.3.1",
4
+ "description": "MCP server for VibeRaven production-readiness: check_readiness, verify, heal, audit, and strict gate tools for Cursor, Claude Code, and Codex.",
5
+ "license": "MIT",
6
+ "author": "VibeRaven",
7
+ "mcpName": "io.github.ohad6k/viberaven",
8
+ "homepage": "https://viberaven.dev/mcp.md",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/ohad6k/VibeRaven.git",
12
+ "directory": "packages/mcp"
13
+ },
14
+ "bugs": {
15
+ "url": "https://github.com/ohad6k/VibeRaven/issues"
16
+ },
17
+ "keywords": [
18
+ "viberaven",
19
+ "mcp",
20
+ "claude-code",
21
+ "codex",
22
+ "cursor",
23
+ "launch-readiness",
24
+ "production"
25
+ ],
26
+ "publishConfig": {
27
+ "access": "public",
28
+ "tag": "latest"
29
+ },
30
+ "bin": {
31
+ "viberaven-mcp": "dist/server.js"
32
+ },
33
+ "files": [
34
+ "dist",
35
+ "README.md"
36
+ ],
37
+ "engines": {
38
+ "node": ">=20"
39
+ },
40
+ "scripts": {
41
+ "build": "node scripts/build.mjs",
42
+ "typecheck": "tsc -p tsconfig.json --noEmit",
43
+ "presmoke": "npm run build",
44
+ "smoke": "node scripts/smoke.mjs",
45
+ "pretest": "npm run build",
46
+ "test": "vitest run"
47
+ },
48
+ "dependencies": {
49
+ "@modelcontextprotocol/sdk": "^1.0.0"
50
+ },
51
+ "devDependencies": {
52
+ "esbuild": "^0.25.0",
53
+ "typescript": "^5.8.0",
54
+ "vitest": "^3.2.0"
55
+ }
56
+ }