@zswarm/mcp

stdio MCP server. One tool named zswarm with an op enum, dispatched through @zswarm/core.

Install

npm install @zswarm/mcp

From a checkout of this repo:

npm install ./packages/mcp

Requires Zellij >= 0.42 and Node >= 20. The bin is zswarm-mcp.

Usage

{
  "mcpServers": {
    "zswarm": {
      "command": "/path/to/node",
      "args": ["/path/to/node_modules/@zswarm/mcp/dist/mcp-server.js"],
      "env": { "ZSWARM_SESSION": "<session-name>" }
    }
  }
}

zswarm({ op: "list" })
zswarm({ op: "send", to: "terminal_2", body: "ping" })

Some MCP hosts spawn servers outside your shell and inherit neither PATH nor the Zellij environment. Give the interpreter an absolute path and set ZSWARM_SESSION. Forward ZELLIJ_PANE_ID (or set ZSWARM_FROM) so send labels [zswarm from=…] with the sending pane instead of swarm. ZSWARM_SSH or ZSWARM_SERVE routes the same tool at a remote crew. Details: the zswarm README.

License

MIT