@viberaven/mcp 1.0.4 → 1.0.6
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 +61 -56
- package/bin/server.js +1 -1
- package/package.json +44 -44
package/README.md
CHANGED
|
@@ -1,60 +1,65 @@
|
|
|
1
|
-
# @viberaven/mcp
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
- `
|
|
28
|
-
- `
|
|
29
|
-
- `
|
|
30
|
-
- `
|
|
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
|
+
## 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`
|
|
31
35
|
- `viberaven_heal_plan` -> `npx -y viberaven --heal --plan`
|
|
32
36
|
- `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
|
|
33
37
|
- `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
https://viberaven.dev/schemas/
|
|
49
|
-
https://viberaven.dev/schemas/
|
|
50
|
-
https://viberaven.dev/schemas/
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
38
|
+
- `viberaven_validate_npm_package` -> `npx -y viberaven validate-npm-package --json`
|
|
39
|
+
|
|
40
|
+
`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`.
|
|
41
|
+
|
|
42
|
+
After one fix, 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.
|
|
60
65
|
|
package/bin/server.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
const { spawn } = require('node:child_process');
|
|
3
3
|
let spawnChild = spawn;
|
|
4
4
|
|
|
5
|
-
const SERVER_INFO = { name: 'viberaven-mcp', version: '1.0.
|
|
5
|
+
const SERVER_INFO = { name: 'viberaven-mcp', version: '1.0.6' };
|
|
6
6
|
const CLI_PACKAGE = '@viberaven/cli';
|
|
7
7
|
|
|
8
8
|
const cwdSchema = {
|
package/package.json
CHANGED
|
@@ -1,44 +1,44 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@viberaven/mcp",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "
|
|
5
|
-
"license": "UNLICENSED",
|
|
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": "bin/server.js"
|
|
32
|
-
},
|
|
33
|
-
"files": [
|
|
34
|
-
"bin",
|
|
35
|
-
"README.md"
|
|
36
|
-
],
|
|
37
|
-
"engines": {
|
|
38
|
-
"node": ">=20"
|
|
39
|
-
},
|
|
40
|
-
"scripts": {
|
|
41
|
-
"smoke": "node scripts/smoke.mjs",
|
|
42
|
-
"test": "vitest run"
|
|
43
|
-
}
|
|
44
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@viberaven/mcp",
|
|
3
|
+
"version": "1.0.6",
|
|
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": "UNLICENSED",
|
|
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": "bin/server.js"
|
|
32
|
+
},
|
|
33
|
+
"files": [
|
|
34
|
+
"bin",
|
|
35
|
+
"README.md"
|
|
36
|
+
],
|
|
37
|
+
"engines": {
|
|
38
|
+
"node": ">=20"
|
|
39
|
+
},
|
|
40
|
+
"scripts": {
|
|
41
|
+
"smoke": "node scripts/smoke.mjs",
|
|
42
|
+
"test": "vitest run"
|
|
43
|
+
}
|
|
44
|
+
}
|