@vibevibes/mcp 0.3.0 → 0.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 +30 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,11 @@
|
|
|
1
1
|
# @vibevibes/mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Runtime engine + MCP server for [vibevibes](https://github.com/vibevibes/sdk) experiences.
|
|
4
4
|
|
|
5
|
-
Agents connect via MCP. Humans connect via browser. Same room, same state.
|
|
5
|
+
Agents connect via MCP. Humans connect via browser. Same room, same state, same tools.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/@vibevibes/mcp)
|
|
8
|
+
[](./LICENSE)
|
|
6
9
|
|
|
7
10
|
## Install
|
|
8
11
|
|
|
@@ -13,37 +16,52 @@ npm install @vibevibes/mcp
|
|
|
13
16
|
## Quick Start
|
|
14
17
|
|
|
15
18
|
```bash
|
|
16
|
-
#
|
|
19
|
+
# Serve an experience (Express + WebSocket + browser viewer)
|
|
17
20
|
npx vibevibes-serve ./my-experience
|
|
18
21
|
|
|
19
|
-
# Or
|
|
22
|
+
# Or run as an MCP server (for AI agents to connect)
|
|
20
23
|
npx vibevibes-mcp
|
|
21
24
|
```
|
|
22
25
|
|
|
26
|
+
Open http://localhost:4321 in the browser. Connect an agent via MCP. Both are in the same room.
|
|
27
|
+
|
|
23
28
|
## How It Works
|
|
24
29
|
|
|
25
|
-
1.
|
|
30
|
+
1. You define an experience with [@vibevibes/sdk](https://github.com/vibevibes/sdk) (tools + canvas)
|
|
26
31
|
2. This server loads and runs it
|
|
27
32
|
3. Agents connect via MCP tools (`connect`, `act`, `look`)
|
|
28
|
-
4. Humans open the browser to see the canvas
|
|
33
|
+
4. Humans open the browser viewer to see the canvas
|
|
29
34
|
5. Everyone shares the same state — tools are the only mutation path
|
|
30
35
|
|
|
36
|
+
```
|
|
37
|
+
Browser (Canvas) <--WebSocket--> vibevibes-serve <--MCP--> AI Agent
|
|
38
|
+
```
|
|
39
|
+
|
|
31
40
|
## MCP Tools
|
|
32
41
|
|
|
33
42
|
| Tool | Purpose |
|
|
34
43
|
|------|---------|
|
|
35
|
-
| `connect` | Join the
|
|
36
|
-
| `act` | Execute a tool
|
|
37
|
-
| `look` | Observe current state |
|
|
38
|
-
| `disconnect` | Leave room |
|
|
44
|
+
| `connect` | Join the room. Returns available tools, current state, browser URL |
|
|
45
|
+
| `act` | Execute a tool — same tools the human uses via the canvas |
|
|
46
|
+
| `look` | Observe current state and recent events |
|
|
47
|
+
| `disconnect` | Leave the room |
|
|
48
|
+
|
|
49
|
+
## Features
|
|
50
|
+
|
|
51
|
+
- **Hot reload** — edit `src/index.tsx`, save, see changes instantly
|
|
52
|
+
- **TypeScript bundling** — esbuild compiles experiences on the fly
|
|
53
|
+
- **Tick engine** — optional fixed-rate game loop (`netcode: "tick"`)
|
|
54
|
+
- **Protocol mode** — load experiences from `manifest.json` + subprocess
|
|
55
|
+
- **Ephemeral state** — per-actor transient data (cursors, typing indicators)
|
|
56
|
+
- **Agent memory** — persistent per-session key-value store
|
|
39
57
|
|
|
40
58
|
## Ecosystem
|
|
41
59
|
|
|
42
60
|
| Package | Description |
|
|
43
61
|
|---------|-------------|
|
|
44
62
|
| [@vibevibes/sdk](https://github.com/vibevibes/sdk) | Define experiences — tools, canvas, state |
|
|
45
|
-
| **@vibevibes/mcp**
|
|
46
|
-
| [create
|
|
63
|
+
| **@vibevibes/mcp** | Runtime engine — MCP server + WebSocket + viewer |
|
|
64
|
+
| [@vibevibes/create](https://github.com/vibevibes/create) | `npx @vibevibes/create` — scaffold in seconds |
|
|
47
65
|
| [experiences](https://github.com/vibevibes/experiences) | Example experiences — fork and remix |
|
|
48
66
|
|
|
49
67
|
## License
|