@amirhosseinnateghi/vibed-mcp 0.1.0

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.
Files changed (3) hide show
  1. package/README.md +59 -0
  2. package/dist/index.js +11034 -0
  3. package/package.json +29 -0
package/README.md ADDED
@@ -0,0 +1,59 @@
1
+ # @amirhosseinnateghi/vibed-mcp — vibed MCP server
2
+
3
+ The **universal** vibed connector: a Model Context Protocol server that lets any
4
+ MCP client (Codex, Cursor, Gemini CLI, Claude Desktop, …) "make it vibed" as
5
+ native tools — no per-platform skill, no shelling out.
6
+
7
+ It reuses the exact engine of the [`vibed` CLI](../cli), so the "vibeable" rules
8
+ and publish behavior never diverge. Zero runtime dependencies (the MCP stdio
9
+ protocol is implemented directly and the engine is bundled), so `npx @amirhosseinnateghi/vibed-mcp`
10
+ needs no install.
11
+
12
+ ## Tools
13
+
14
+ | Tool | What it does |
15
+ |---|---|
16
+ | `vibed_check` | Bundle + validate a project against the sandbox rules (read-only). |
17
+ | `vibed_whoami` | Is this machine signed in, and as whom? |
18
+ | `vibed_login` | Start browser-approved device login; returns the approve URL + code. |
19
+ | `vibed_login_wait` | Block until the user approves; saves the token. |
20
+ | `vibed_publish` | Bundle + publish; returns the URL (or the blockers to fix). |
21
+
22
+ ## Configure your client
23
+
24
+ The server runs over stdio. Point your client at `npx -y @amirhosseinnateghi/vibed-mcp`.
25
+
26
+ **Codex** — `~/.codex/config.toml`:
27
+ ```toml
28
+ [mcp_servers.vibed]
29
+ command = "npx"
30
+ args = ["-y", "@amirhosseinnateghi/vibed-mcp"]
31
+ ```
32
+
33
+ **Cursor** — `~/.cursor/mcp.json` (or project `.cursor/mcp.json`):
34
+ ```json
35
+ { "mcpServers": { "vibed": { "command": "npx", "args": ["-y", "@amirhosseinnateghi/vibed-mcp"] } } }
36
+ ```
37
+
38
+ **Gemini CLI** — `~/.gemini/settings.json`:
39
+ ```json
40
+ { "mcpServers": { "vibed": { "command": "npx", "args": ["-y", "@amirhosseinnateghi/vibed-mcp"] } } }
41
+ ```
42
+
43
+ **Claude Code** (the plugin is the primary path, but MCP works too):
44
+ ```bash
45
+ claude mcp add vibed -- npx -y @amirhosseinnateghi/vibed-mcp
46
+ ```
47
+
48
+ For a local/self-hosted vibed, set the API base via env in the same config, e.g.
49
+ `env = { VIBED_API = "http://localhost:3200" }` (TOML) or
50
+ `"env": { "VIBED_API": "http://localhost:3200" }` (JSON).
51
+
52
+ ## Dev
53
+
54
+ ```bash
55
+ pnpm --filter @amirhosseinnateghi/vibed-mcp build # → dist/index.js (bundled, standalone)
56
+ pnpm --filter @amirhosseinnateghi/vibed-mcp dev # run from source over stdio
57
+ ```
58
+
59
+ See [docs/connector.md](../../docs/connector.md) for the full picture.