lazy-cherry-pick-mcp 0.15.0

package/README.md

@@ -0,0 +1,53 @@
+# lazy-cherry-pick-mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server exposing **22 git
+tools** (status, branches, commits, diffs, cherry-pick, fetch/pull/push, conflict
+resolution) so AI clients — Claude Desktop, Cursor, VS Code, etc. — can drive real
+git workflows on a repo on your machine, including an AI-driven conflict-resolution
+loop.
+
+This package is a thin launcher: on first run it downloads the matching
+[`sidecar`](https://github.com/tentaikhoan24/lazy-cherry-pick) binary from the
+project's GitHub Releases, caches it locally, and execs it with `--mcp`. No Tauri /
+desktop app install required.
+
+> **Platform support**: Windows x64 only for now. Other platforms exit with an error
+> pointing to build-from-source instructions.
+
+## Usage
+
+Add to your MCP client config (e.g. Claude Desktop's `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "lazy-cherry-pick": {
+      "command": "npx",
+      "args": ["-y", "lazy-cherry-pick-mcp"],
+      "env": {
+        "LCP_DEFAULT_REPO": "D:\\path\\to\\your\\repo"
+      }
+    }
+  }
+}
+```
+
+- `LCP_DEFAULT_REPO` is optional. Without it, the model must pass an absolute `repo`
+  path on every tool call.
+- The first call may take a few seconds while the sidecar binary downloads; it is
+  cached afterwards (per-version) under `%LOCALAPPDATA%\lazy-cherry-pick-mcp\`.
+
+## Tool catalog & conflict-resolution loop
+
+See [docs/MCP.md](https://github.com/tentaikhoan24/lazy-cherry-pick/blob/master/docs/MCP.md)
+in the main repo for the full 22-tool catalog, the AI-driven conflict-resolution
+loop, and protocol details.
+
+## Troubleshooting
+
+- **404 downloading the sidecar binary right after a new version is published**: the
+  corresponding GitHub Release may still be a draft. Wait for it to be published, or
+  use the previous version pinned (`npx lazy-cherry-pick-mcp@<previous-version>`).
+- **Unsupported platform error**: only Windows x64 has a prebuilt binary today. Build
+  the sidecar from source (see the main repo README) and point your MCP client's
+  `command` directly at the resulting `.exe` with `args: ["--mcp"]`.

package/bin/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+const { spawnSync } = require('child_process');
+
+const pkg = require('../package.json');
+
+const REPO = 'tentaikhoan24/lazy-cherry-pick';
+
+// process.platform-process.arch -> release asset name (target-triple suffix)
+const ASSET_BY_PLATFORM = {
+  'win32-x64': 'sidecar-x86_64-pc-windows-msvc.exe',
+};
+
+function assetName() {
+  return ASSET_BY_PLATFORM[`${process.platform}-${process.arch}`];
+}
+
+function cacheDir() {
+  const base = process.platform === 'win32'
+    ? (process.env.LOCALAPPDATA || os.homedir())
+    : (process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache'));
+  return path.join(base, 'lazy-cherry-pick-mcp', `v${pkg.version}`);
+}
+
+function download(url, dest, redirectsLeft) {
+  if (redirectsLeft === undefined) redirectsLeft = 5;
+  return new Promise((resolve, reject) => {
+    const req = https.get(url, { headers: { 'User-Agent': 'lazy-cherry-pick-mcp' } }, (res) => {
+      const { statusCode, headers } = res;
+      if (statusCode >= 300 && statusCode < 400 && headers.location) {
+        res.resume();
+        if (redirectsLeft <= 0) return reject(new Error('too many redirects'));
+        return download(headers.location, dest, redirectsLeft - 1).then(resolve, reject);
+      }
+      if (statusCode !== 200) {
+        res.resume();
+        return reject(new Error(`HTTP ${statusCode} fetching ${url}`));
+      }
+      const file = fs.createWriteStream(dest);
+      res.pipe(file);
+      file.on('finish', () => file.close((err) => (err ? reject(err) : resolve())));
+      file.on('error', reject);
+    });
+    req.on('error', reject);
+  });
+}
+
+async function ensureBinary() {
+  const asset = assetName();
+  if (!asset) {
+    throw new Error(
+      `unsupported platform ${process.platform}/${process.arch} — only Windows x64 is published today. ` +
+      `Build the sidecar from source: https://github.com/${REPO}#mcp-server--ai-integration`
+    );
+  }
+
+  const dir = cacheDir();
+  const dest = path.join(dir, asset);
+  if (fs.existsSync(dest)) return dest;
+
+  fs.mkdirSync(dir, { recursive: true });
+  const url = `https://github.com/${REPO}/releases/download/v${pkg.version}/${asset}`;
+  const tmp = `${dest}.${process.pid}.tmp`;
+  process.stderr.write(`lazy-cherry-pick-mcp: downloading sidecar binary (v${pkg.version})...\n`);
+  try {
+    await download(url, tmp);
+  } catch (err) {
+    try { fs.unlinkSync(tmp); } catch {}
+    throw new Error(`failed to download ${url}: ${err.message}`);
+  }
+  fs.renameSync(tmp, dest);
+  return dest;
+}
+
+(async () => {
+  let bin;
+  try {
+    bin = await ensureBinary();
+  } catch (err) {
+    process.stderr.write(`lazy-cherry-pick-mcp: ${err.message}\n`);
+    process.exit(1);
+  }
+
+  const result = spawnSync(bin, ['--mcp'], { stdio: 'inherit' });
+  if (result.error) {
+    process.stderr.write(`lazy-cherry-pick-mcp: failed to launch sidecar: ${result.error.message}\n`);
+    process.exit(1);
+  }
+  process.exit(result.status === null ? 1 : result.status);
+})();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "lazy-cherry-pick-mcp",
+  "version": "0.15.0",
+  "description": "MCP server for Lazy Cherry Pick: AI tools for git status, branches, commits, diffs, cherry-pick, fetch/pull/push, and conflict resolution. Run via npx, no desktop install needed.",
+  "license": "MIT",
+  "homepage": "https://github.com/tentaikhoan24/lazy-cherry-pick",
+  "bugs": "https://github.com/tentaikhoan24/lazy-cherry-pick/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tentaikhoan24/lazy-cherry-pick.git",
+    "directory": "mcp-npm"
+  },
+  "bin": {
+    "lazy-cherry-pick-mcp": "bin/cli.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "git",
+    "cherry-pick",
+    "ai",
+    "claude",
+    "llm-tools"
+  ]
+}