clawborrator-mcp 0.0.30 → 0.0.31
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 +20 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,13 +1,17 @@
|
|
|
1
1
|
# clawborrator-mcp (channel_v1)
|
|
2
2
|
|
|
3
3
|
MCP server that connects each running Claude Code instance to a
|
|
4
|
-
[`
|
|
5
|
-
Designed to be invoked by Claude Code via `.mcp.json`;
|
|
6
|
-
a long-lived stdio MCP server AND a short-lived hook
|
|
7
|
-
by the `--hook=<HookName>` CLI flag).
|
|
4
|
+
clawborrator [`hub`](https://github.com/clawborrator/hub_v1) over
|
|
5
|
+
WebSocket. Designed to be invoked by Claude Code via `.mcp.json`;
|
|
6
|
+
runs as both a long-lived stdio MCP server AND a short-lived hook
|
|
7
|
+
spawn (selected by the `--hook=<HookName>` CLI flag).
|
|
8
8
|
|
|
9
9
|
Published as [`clawborrator-mcp`](https://www.npmjs.com/package/clawborrator-mcp)
|
|
10
|
-
on npm.
|
|
10
|
+
on npm. Sibling repos:
|
|
11
|
+
|
|
12
|
+
- [`hub_v1`](https://github.com/clawborrator/hub_v1) — the hub server (REST + WS), deployed at https://next.clawborrator.com
|
|
13
|
+
- [`cli_v1`](https://github.com/clawborrator/cli_v1) — `claw`, the operator CLI ([`clawborrator-cli`](https://www.npmjs.com/package/clawborrator-cli) on npm)
|
|
14
|
+
- [`desktop_v1`](https://github.com/clawborrator/desktop_v1) — `clawborrator-supervisor`, the desktop daemon for managed CC sessions
|
|
11
15
|
|
|
12
16
|
> **Status: production hub at [`next.clawborrator.com`](https://next.clawborrator.com).**
|
|
13
17
|
> Local dev uses `ws://localhost:8787`. Both supported.
|
|
@@ -40,12 +44,18 @@ Set in your project's `.mcp.json`:
|
|
|
40
44
|
| `CLAWBORRATOR_REUSE_SESSION_ID` | no | Opt-in: reconnect rebinds to a known session id rather than creating a fresh one |
|
|
41
45
|
| `CLAWBORRATOR_LOG_LEVEL` | no | `debug`, `info`, `warn`, `error`; default `info` |
|
|
42
46
|
|
|
43
|
-
Get the snippet pre-filled with the right URL + token via
|
|
47
|
+
Get the snippet pre-filled with the right URL + token via the
|
|
48
|
+
[`clawborrator-cli`](https://www.npmjs.com/package/clawborrator-cli):
|
|
44
49
|
|
|
45
50
|
```bash
|
|
46
|
-
|
|
51
|
+
npx clawborrator-cli token mint --kind=channel --name=mbp --mcp-snippet --out .mcp.json
|
|
47
52
|
```
|
|
48
53
|
|
|
54
|
+
If you're running the [desktop daemon](https://github.com/clawborrator/desktop_v1)
|
|
55
|
+
(`clawborrator-supervisor`), it mints channel tokens server-side
|
|
56
|
+
when it spawns managed Claude Code sessions for you — the `.mcp.json`
|
|
57
|
+
ends up in the spawned project automatically.
|
|
58
|
+
|
|
49
59
|
---
|
|
50
60
|
|
|
51
61
|
## What it does
|
|
@@ -68,7 +78,9 @@ claw token mint --kind=channel --name=mbp --mcp-snippet
|
|
|
68
78
|
5. Echoes stdin to stdout so Claude's hook chain stays intact.
|
|
69
79
|
6. Exits cleanly even if the hub is unreachable — never breaks the operator's actual Claude flow.
|
|
70
80
|
|
|
71
|
-
Hooks are installed
|
|
81
|
+
Hooks are auto-installed on first MCP startup: `clawborrator-mcp` reconciles
|
|
82
|
+
`.claude/settings.json` to add (or refresh) the entries that point at
|
|
83
|
+
`dist-hook/clawborrator-tail.mjs`. No separate install step.
|
|
72
84
|
|
|
73
85
|
---
|
|
74
86
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "clawborrator-mcp",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.31",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "clawborrator channel for hub_v1 — MCP server that connects Claude Code to a hub over WebSocket, with hooks for activity capture and tools for cross-session routing.",
|
|
6
6
|
"license": "MIT",
|