@viberaven/mcp 1.5.1 → 1.5.2
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 +65 -69
- package/dist/lib/cli-runner.js +1 -1
- package/dist/server.js +2 -2
- package/dist/tools/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,69 +1,65 @@
|
|
|
1
|
-
# @viberaven/mcp
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/@viberaven/mcp)
|
|
4
|
-
[](https://www.npmjs.com/package/@viberaven/mcp)
|
|
5
|
-
[](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
|
-
The MCP server wraps the stable CLI package: `npx -y viberaven`.
|
|
12
|
-
|
|
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
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
- `
|
|
30
|
-
- `
|
|
31
|
-
- `
|
|
32
|
-
- `
|
|
33
|
-
- `
|
|
34
|
-
- `
|
|
35
|
-
- `
|
|
36
|
-
- `
|
|
37
|
-
- `
|
|
38
|
-
- `
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
##
|
|
63
|
-
|
|
64
|
-
|
|
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
|
-
|
|
1
|
+
# @viberaven/mcp
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@viberaven/mcp)
|
|
4
|
+
[](https://www.npmjs.com/package/@viberaven/mcp)
|
|
5
|
+
[](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
|
+
The MCP server wraps the stable CLI package: `npx -y viberaven`.
|
|
12
|
+
|
|
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
|
+
This package is the only MCP entrypoint in 1.5.2. The main `viberaven` CLI package does not start an MCP server.
|
|
22
|
+
|
|
23
|
+
## Tools
|
|
24
|
+
|
|
25
|
+
- `viberaven_check_readiness` -> `npx -y viberaven check --json`
|
|
26
|
+
- `viberaven_verify` -> `npx -y viberaven check --json`
|
|
27
|
+
- `viberaven_audit` -> `npx -y viberaven audit --vercel-supabase`
|
|
28
|
+
- `viberaven_init_rules` -> `npx -y viberaven init`
|
|
29
|
+
- `viberaven_clean_plan` -> `npx -y viberaven clean --plan`: writes and returns a context cleanup review plan; deletes nothing (fixed in 1.5.2)
|
|
30
|
+
- `viberaven_strict_gate` -> `npx -y viberaven --strict --json`
|
|
31
|
+
- `viberaven_gate_result` -> `npx -y viberaven --json`
|
|
32
|
+
- `viberaven_context_map` -> `npx -y viberaven --condense`
|
|
33
|
+
- `viberaven_actions` -> `npx -y viberaven actions`
|
|
34
|
+
- `viberaven_verify_action` -> `npx -y viberaven verify --action <id>`
|
|
35
|
+
- `viberaven_heal_plan` -> `npx -y viberaven --heal --plan`
|
|
36
|
+
- `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
|
|
37
|
+
- `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`
|
|
38
|
+
- `viberaven_validate_npm_package` -> `npx -y viberaven validate-npm-package --json`
|
|
39
|
+
|
|
40
|
+
`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`.
|
|
41
|
+
|
|
42
|
+
After a batch of fixes, call `viberaven_verify`. Before deploy or CI pass, call `viberaven_strict_gate` or run:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npx -y viberaven --strict
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## Machine Artifact Contract
|
|
49
|
+
|
|
50
|
+
```text
|
|
51
|
+
docs/contracts/artifacts.md
|
|
52
|
+
https://viberaven.dev/schemas/gate-result.schema.json
|
|
53
|
+
https://viberaven.dev/schemas/context-map.schema.json
|
|
54
|
+
https://viberaven.dev/schemas/gap.schema.json
|
|
55
|
+
https://viberaven.dev/schemas/heal-result.schema.json
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Login
|
|
59
|
+
|
|
60
|
+
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.
|
|
61
|
+
|
|
62
|
+
## Security
|
|
63
|
+
|
|
64
|
+
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.
|
|
65
|
+
|
package/dist/lib/cli-runner.js
CHANGED
|
@@ -52,7 +52,7 @@ function mcpVersion() {
|
|
|
52
52
|
} catch {
|
|
53
53
|
}
|
|
54
54
|
}
|
|
55
|
-
found ??= true ? "1.5.
|
|
55
|
+
found ??= true ? "1.5.2" : void 0;
|
|
56
56
|
if (!found || !PLAIN_VERSION.test(found)) {
|
|
57
57
|
throw new Error(`Could not read a valid ${MCP_PACKAGE} version (got ${JSON.stringify(found)}), so the matching ${CLI_PACKAGE} cannot be pinned.`);
|
|
58
58
|
}
|
package/dist/server.js
CHANGED
|
@@ -191,7 +191,7 @@ function mcpVersion() {
|
|
|
191
191
|
} catch {
|
|
192
192
|
}
|
|
193
193
|
}
|
|
194
|
-
found ??= true ? "1.5.
|
|
194
|
+
found ??= true ? "1.5.2" : void 0;
|
|
195
195
|
if (!found || !PLAIN_VERSION.test(found)) {
|
|
196
196
|
throw new Error(`Could not read a valid ${MCP_PACKAGE} version (got ${JSON.stringify(found)}), so the matching ${CLI_PACKAGE} cannot be pinned.`);
|
|
197
197
|
}
|
|
@@ -361,7 +361,7 @@ async function handleRequest(method, params) {
|
|
|
361
361
|
}
|
|
362
362
|
|
|
363
363
|
// src/server.ts
|
|
364
|
-
var SERVER_INFO = { name: "viberaven-mcp", version: "1.5.
|
|
364
|
+
var SERVER_INFO = { name: "viberaven-mcp", version: "1.5.2" };
|
|
365
365
|
var server = new import_server.Server(SERVER_INFO, { capabilities: { tools: {} } });
|
|
366
366
|
server.setRequestHandler(
|
|
367
367
|
import_types.ListToolsRequestSchema,
|
package/dist/tools/index.js
CHANGED
|
@@ -192,7 +192,7 @@ function mcpVersion() {
|
|
|
192
192
|
} catch {
|
|
193
193
|
}
|
|
194
194
|
}
|
|
195
|
-
found ??= true ? "1.5.
|
|
195
|
+
found ??= true ? "1.5.2" : void 0;
|
|
196
196
|
if (!found || !PLAIN_VERSION.test(found)) {
|
|
197
197
|
throw new Error(`Could not read a valid ${MCP_PACKAGE} version (got ${JSON.stringify(found)}), so the matching ${CLI_PACKAGE} cannot be pinned.`);
|
|
198
198
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@viberaven/mcp",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.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
5
|
"license": "MIT",
|
|
6
6
|
"author": "VibeRaven",
|