mcp-prune 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# mcp-prune
+
+Audit MCP server usage from Claude Code transcripts. Find idle servers so you
+can prune them and stop loading their tool schemas into every conversation.
+
+This npm package wraps the Rust binary distributed via GitHub Releases.
+
+## Install
+
+```sh
+npm install -g mcp-prune
+# or run without installing
+npx mcp-prune report
+```
+
+On install, a small postinstall script downloads the prebuilt binary for your
+platform (`darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`) from the
+matching GitHub Release. No Rust toolchain required.
+
+## Usage
+
+```sh
+mcp-prune install          # add SessionStart hook to ~/.claude/settings.json
+mcp-prune report           # grouped usage report
+mcp-prune idle             # only idle servers
+mcp-prune apply            # interactive prune
+```
+
+See the full README at https://github.com/mstuart/mcp-prune for details.
+
+## Troubleshooting
+
+If the binary fails to download during install (corp proxy, offline, etc.):
+
+```sh
+npm rebuild mcp-prune        # retry the download
+```
+
+Or build from source:
+
+```sh
+cargo install --git https://github.com/mstuart/mcp-prune
+```
+
+## License
+
+MIT

package/bin/mcp-prune.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Thin shim that exec's the platform-native binary that postinstall placed
+// next to this file. Keeping this as JS (not the binary itself) means npm can
+// always link a stable `bin/mcp-prune.js` regardless of host arch.
+
+'use strict';
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const ext = process.platform === 'win32' ? '.exe' : '';
+const binPath = path.join(__dirname, `mcp-prune-bin${ext}`);
+
+if (!fs.existsSync(binPath)) {
+  console.error('mcp-prune: native binary not found at', binPath);
+  console.error('mcp-prune: re-run install with `npm rebuild mcp-prune` (postinstall fetches it from GitHub Releases).');
+  console.error('mcp-prune: if this keeps failing, report at https://github.com/mstuart/mcp-prune/issues');
+  process.exit(1);
+}
+
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+  console.error('mcp-prune:', result.error.message);
+  process.exit(1);
+}
+process.exit(result.status ?? 1);

package/install.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// Downloads the prebuilt mcp-prune binary for this platform from the matching
+// GitHub Release and writes it next to the Node shim in ./bin/.
+//
+// Fails loudly with a clear message on unsupported platforms or network errors.
+// The shim in bin/mcp-prune.js is the npm entry point and will report a
+// friendlier error if the binary is missing at run time, so a postinstall
+// failure here doesn't break the install — it just defers the error.
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const zlib = require('zlib');
+const { pipeline } = require('stream/promises');
+
+const REPO = 'mstuart/mcp-prune';
+const VERSION = require('./package.json').version;
+
+const TARGETS = {
+  'darwin-arm64': 'aarch64-apple-darwin',
+  'darwin-x64': 'x86_64-apple-darwin',
+  'linux-x64': 'x86_64-unknown-linux-gnu',
+  'linux-arm64': 'aarch64-unknown-linux-gnu',
+};
+
+function targetTriple() {
+  const key = `${process.platform}-${process.arch}`;
+  const triple = TARGETS[key];
+  if (!triple) {
+    const supported = Object.keys(TARGETS).join(', ');
+    throw new Error(
+      `unsupported platform: ${key}. Supported: ${supported}. ` +
+        `Build from source with \`cargo install --git https://github.com/${REPO}\`.`
+    );
+  }
+  return triple;
+}
+
+function get(url, redirects = 5) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { 'user-agent': `mcp-prune-npm/${VERSION}` } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          if (redirects === 0) {
+            reject(new Error('too many redirects'));
+            return;
+          }
+          res.resume();
+          resolve(get(res.headers.location, redirects - 1));
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`GET ${url} returned ${res.statusCode}`));
+          return;
+        }
+        resolve(res);
+      })
+      .on('error', reject);
+  });
+}
+
+async function main() {
+  const triple = targetTriple();
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/mcp-prune-${triple}.gz`;
+  const outDir = path.join(__dirname, 'bin');
+  const outPath = path.join(outDir, process.platform === 'win32' ? 'mcp-prune-bin.exe' : 'mcp-prune-bin');
+
+  fs.mkdirSync(outDir, { recursive: true });
+
+  process.stdout.write(`mcp-prune: downloading ${triple} binary... `);
+  const res = await get(url);
+  await pipeline(res, zlib.createGunzip(), fs.createWriteStream(outPath, { mode: 0o755 }));
+  process.stdout.write('done\n');
+}
+
+main().catch((err) => {
+  console.error(`mcp-prune: postinstall failed: ${err.message}`);
+  console.error(`mcp-prune: the binary will be downloaded on first run, or you can re-run \`npm rebuild mcp-prune\`.`);
+  process.exit(0);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "mcp-prune",
+  "version": "0.1.0",
+  "description": "Audit MCP server usage from Claude Code transcripts. Find idle servers to prune.",
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "anthropic",
+    "audit"
+  ],
+  "homepage": "https://github.com/mstuart/mcp-prune#readme",
+  "bugs": {
+    "url": "https://github.com/mstuart/mcp-prune/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mstuart/mcp-prune.git"
+  },
+  "license": "MIT",
+  "author": "Mark Stuart <mstuart@users.noreply.github.com>",
+  "bin": {
+    "mcp-prune": "bin/mcp-prune.js"
+  },
+  "files": [
+    "bin/mcp-prune.js",
+    "install.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}