@usex/mikrotik-mcp 4.3.0 → 4.4.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.
package/README.md CHANGED
@@ -119,6 +119,34 @@ bun run start # serve from source
119
119
  bun run build # bundle to dist/
120
120
  ```
121
121
 
122
+ ### As an MCP Bundle (`.mcpb`)
123
+
124
+ A one-click install for Claude Desktop and other MCPB hosts — no Bun, Node or npm
125
+ needed on the machine, and the router credentials are entered in the host's UI
126
+ rather than a shell.
127
+
128
+ ```bash
129
+ bun run build:mcp # bundle for this machine
130
+ bun run build:mcp --target linux-x64 # or one specific target
131
+ bun run build:mcp:all # every target
132
+ ```
133
+
134
+ Bundles land in `dist-mcpb/` as `mikrotik-mcp-<version>-<platform>-<arch>.mcpb`.
135
+ Open one with your MCPB host (on Claude Desktop, drag it onto Settings →
136
+ Extensions) and fill in the router address and credentials it prompts for.
137
+
138
+ Because the server is Bun-native — `bun:sqlite`, `Bun.serve`, `Bun.S3Client`, and
139
+ `@tikoci/centrs`, which ships raw TypeScript — it cannot run on the Node runtime an
140
+ MCPB host provides. Each bundle therefore **vendors the Bun binary it was built
141
+ against** and runs `runtime/bun dist/cli.js serve`, so every subsystem (MAC-Telnet,
142
+ the dashboard, S3 backups) behaves exactly as it does from source. That costs about
143
+ 60 MB per bundle and makes each one platform-specific — hence one artifact per
144
+ platform/arch rather than a single universal file.
145
+
146
+ The build stages the bundle, validates the manifest, and drives the staged server
147
+ over stdio (`initialize` + `tools/list`, asserting the tool count matches the
148
+ manifest) before packing. Pass `--no-smoke` to skip that last check.
149
+
122
150
  ## The tool catalog
123
151
 
124
152
  **706 tools across 111 modules.** Full, always-current reference (parameters +