@rebind.gg/mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -3,13 +3,33 @@
 Stdio MCP server that exposes Rebind as computer-use tools: `screenshot`,
 `screenshot_window`, `zoom`, `click` (verified), `move_mouse`, `type`, `key`,
 `scroll`, `run_lua`, `wait`, window control, and `calibrate`. Wraps
-`@rebind.gg/client-ts`; requires a remote-control
-server running in Rebind — `remote.luau` (recommended) or `remote_access.lua`
-(protocol >= 1.1.0). The `click` tool clicks via `hid.press`, which is
+`@rebind.gg/client-ts`; requires the **Rebind** app
+(https://rebind.gg/download) running its Remote Access relay — `remote.luau`
+(recommended) or `remote_access.lua` (protocol >= 1.1.0). The `click` tool clicks via `hid.press`, which is
 coroutine-only; use `remote.luau` or a current `remote_access.lua` (older copies
 called it outside a coroutine, so clicks silently failed).
 
-## Use
+## Install
+
+One command writes the correct config for whichever clients you name — Claude
+Code, Cursor, Codex, OpenCode, VS Code, Windsurf, Zed, and more — each in its
+native format, via [`add-mcp`](https://github.com/neondatabase/add-mcp):
+
+```sh
+npx add-mcp "bunx @rebind.gg/mcp-server" --name rebind \
+  --env REBIND_URL=ws://127.0.0.1:19561 \
+  -g -a claude-code -a cursor -a codex -a opencode
+```
+
+Drop `-a <agent>` for the clients you want, or pass `--all`. `-g` installs
+globally; omit it for project-local config. Restart the client afterward.
+
+Requires **Bun** (the server runs via `bunx`) and the **Rebind** app
+(https://rebind.gg/download) running its Remote Access relay.
+
+## Configure manually
+
+Any MCP client takes the stdio block directly:
 
 ```json
 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rebind.gg/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server exposing Rebind as computer-use tools: screenshot, verified click, type, key, scroll, and window control over the Remote Access protocol.",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -51,13 +51,8 @@ async function main() {
   await client.connect();
 
   const session = new Session(client);
-  try {
-    await session.calibrate();
-  } catch (e) {
-    session.calibration = { calibrated: false, reason: String(e) };
-  }
 
-  const server = new McpServer({ name: "rebind", version: "0.1.1" });
+  const server = new McpServer({ name: "rebind", version: "0.1.2" });
 
   // REBIND_AGENT_LOG=<path>: opt-in telemetry — one JSONL line per tool call
   // ({ts, tool, ok, latency_ms, note}). No screenshot bytes, no user content.
@@ -413,7 +408,8 @@ async function main() {
     "calibrate",
     {
       description:
-        "Re-run the mouse scale probe (auto-runs at startup). Verifies relative mouse counts map 1:1 to pixels; reports pointer-ballistics misconfiguration.",
+        "Run the mouse scale probe. Verifies relative mouse counts map 1:1 to pixels; reports pointer-ballistics misconfiguration. " +
+        "Auto-runs on first click/move_mouse if not already calibrated; call this tool explicitly to re-run.",
     },
     async () => text(JSON.stringify(await session.calibrate())),
   );

package/src/session.ts

@@ -54,9 +54,20 @@ export interface CalibrationResult {
 export class Session {
   lastShot: ShotMapping | null = null;
   calibration: CalibrationResult | null = null;
+  private _calibrating = false;
 
   constructor(readonly client: RebindRemote) {}
 
+  async ensureCalibrated(): Promise<void> {
+    if (this.calibration !== null || this._calibrating) return;
+    this._calibrating = true;
+    try {
+      await this.calibrate();
+    } finally {
+      this._calibrating = false;
+    }
+  }
+
   /** map a point in the last screenshot's image space to screen coords. */
   mapImagePoint(ix: number, iy: number): Point {
     if (!this.lastShot) {
@@ -83,6 +94,7 @@ export class Session {
    * the true cursor. Converges to the exact pixel, usually in a single pass.
    */
   async moveTo(x: number, y: number): Promise<Point & { passes: number }> {
+    await this.ensureCalibrated();
     let at = await this.client.systemMouse();
     let passes = 0;
     while (passes < MOVE_MAX_PASSES) {