mcp-multitool 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andy Liner
+
+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,119 @@
+# mcp-multitool
+
+[![npm version](https://img.shields.io/npm/v/mcp-multitool)](https://www.npmjs.com/package/mcp-multitool)
+[![npm downloads](https://img.shields.io/npm/dm/mcp-multitool)](https://www.npmjs.com/package/mcp-multitool)
+[![license](https://img.shields.io/npm/l/mcp-multitool)](./LICENSE)
+
+A minimal [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server. Currently ships one tool: `wait`.
+
+## Why
+
+Some tasks genuinely need a pause — rate limits, eventual consistency, animations completing, or simply giving a background process time to settle. `mcp-multitool` gives any MCP-compatible client a reliable, configurable `wait` tool without pulling in a larger server.
+
+## Quick Start
+
+### Install
+
+```bash
+npx mcp-multitool
+```
+
+### Configure Your MCP Client
+
+**VS Code** (`.vscode/mcp.json`):
+
+```json
+{
+  "servers": {
+    "mcp-multitool": {
+      "command": "npx",
+      "args": ["mcp-multitool"]
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-multitool": {
+      "command": "npx",
+      "args": ["mcp-multitool"]
+    }
+  }
+}
+```
+
+**Cursor, Windsurf, Continue** — follow each client's MCP server documentation using the same `npx mcp-multitool` command.
+
+## Tool Reference
+
+### `wait`
+
+Wait for a specified duration before continuing.
+
+| Parameter    | Type      | Required | Description                                                                                       |
+| ------------ | --------- | -------- | ------------------------------------------------------------------------------------------------- |
+| `durationMs` | `integer` | ✅       | How long to wait in milliseconds. Must be ≥ 1 and ≤ the configured max (default: 300000 / 5 min). |
+| `reason`     | `string`  | ✅       | Why the wait is needed. Max 64 characters.                                                        |
+
+**Response:** `"Nms have passed."`
+
+**Examples:**
+
+```
+wait  durationMs=2000  reason="settling after write"
+wait  durationMs=5000  reason="rate limit cooldown"
+wait  durationMs=500   reason="animation to complete"
+```
+
+## Environment Variables
+
+| Variable            | Default  | Description                                                                                               |
+| ------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
+| `waitMaxDurationMs` | `300000` | Override the maximum allowed `durationMs`. Must be a positive number. Server refuses to start if invalid. |
+| `wait`              | _(on)_   | Set to `"false"` to disable the `wait` tool at startup.                                                   |
+
+### Disabling Individual Tools
+
+Every tool can be disabled by setting its name to `"false"` in the `env` block of your MCP config.
+
+**VS Code** (`.vscode/mcp.json`):
+
+```json
+{
+  "servers": {
+    "mcp-multitool": {
+      "command": "npx",
+      "args": ["mcp-multitool"],
+      "env": {
+        "wait": "false"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mcp-multitool": {
+      "command": "npx",
+      "args": ["mcp-multitool"],
+      "env": {
+        "wait": "false"
+      }
+    }
+  }
+}
+```
+
+Tools are enabled by default. Only tools explicitly set to `"false"` are skipped at startup.
+
+## Requirements
+
+- Node.js >= 20

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { register as registerWait } from "./tools/wait.js";
+const isEnabled = (name) => process.env[name] !== "false";
+const server = new McpServer({ name: "mcp-multitool", version: "0.1.0" });
+if (isEnabled("wait"))
+    registerWait(server);
+await server.connect(new StdioServerTransport());

package/dist/tools/wait.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/wait.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+const DEFAULT_MAX_MS = 300_000;
+const maxMs = parseMaxDuration();
+function parseMaxDuration() {
+    const env = process.env.waitMaxDurationMs;
+    if (!env)
+        return DEFAULT_MAX_MS;
+    const parsed = Number(env);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        process.stderr.write(`Invalid waitMaxDurationMs: "${env}". Must be a positive number.\n`);
+        process.exit(1);
+    }
+    return parsed;
+}
+const schema = z.object({
+    durationMs: z
+        .number()
+        .int()
+        .min(1)
+        .max(maxMs)
+        .describe(`Milliseconds to wait. Min: 1, max: ${maxMs}.`),
+    reason: z
+        .string()
+        .min(1)
+        .max(64)
+        .describe("Why the wait is needed. Max 64 characters."),
+});
+export function register(server) {
+    server.tool("wait", "Wait for a specified duration before continuing.", schema.shape, async (input) => {
+        try {
+            await new Promise((r) => setTimeout(r, input.durationMs));
+            return {
+                content: [
+                    { type: "text", text: `${input.durationMs}ms have passed.` },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: String(err) }],
+                isError: true,
+            };
+        }
+    });
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "mcp-multitool",
+  "version": "0.1.0",
+  "description": "Minimal MCP server — wait tool and more.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "wait",
+    "tool"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}