@zswarm/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zSwarm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @zswarm/mcp
+
+stdio MCP server. One tool named `zswarm` with an `op` enum, dispatched through
+`@zswarm/core`.
+
+## Install
+
+```bash
+npm install @zswarm/mcp
+```
+
+From a checkout of this repo:
+
+```bash
+npm install ./packages/mcp
+```
+
+Requires Zellij >= 0.42 and Node >= 20. The bin is `zswarm-mcp`.
+
+## Usage
+
+```json
+{
+  "mcpServers": {
+    "zswarm": {
+      "command": "/path/to/node",
+      "args": ["/path/to/node_modules/@zswarm/mcp/dist/mcp-server.js"],
+      "env": { "ZSWARM_SESSION": "<session-name>" }
+    }
+  }
+}
+```
+
+```text
+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`. Details: the [zswarm README](../../README.md).
+
+## License
+
+MIT

package/dist/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp-server.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { dispatchZswarm, mcpInputSchema, MCP_TOOL_DESCRIPTION, } from "@zswarm/core";
+const server = new Server({ name: "zswarm", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "zswarm",
+            description: MCP_TOOL_DESCRIPTION,
+            inputSchema: mcpInputSchema(),
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const name = request.params.name;
+    const args = (request.params.arguments ?? {});
+    if (name !== "zswarm") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: false,
+                        error: { code: "unknown_tool", message: `unknown tool ${name}` },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = await dispatchZswarm(args);
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(result, null, 2) },
+        ],
+        isError: !result.ok,
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@zswarm/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "zSwarm MCP server — Zellij pane coordination",
+  "bin": {
+    "zswarm-mcp": "./dist/mcp-server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "@zswarm/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.14.1",
+    "typescript": "5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/mcp-server.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "mcp": "node dist/mcp-server.js"
+  }
+}