jujugrowth-mcp 1.0.0

package/README.md

@@ -0,0 +1,47 @@
+# @jujugrowth/mcp
+
+A dependency-free MCP (Model Context Protocol) stdio server that connects your
+dev-AI — **Claude Desktop, Claude Code, or Cursor** — directly to jujugrowth.
+Your AI pulls recommendations and their implementable briefs, makes the changes
+**in your own repo** (where you review them via git), and marks them handled —
+no copy-paste.
+
+jujugrowth stays read-only to your systems: this server only reads
+recommendations and writes status back to jujugrowth.
+
+## Setup
+
+1. In jujugrowth: **Settings → Developer → Generate API token** (copy it — shown once).
+2. Add it to your AI tool (path-free via npx — no local install):
+
+**Claude Code:**
+
+```bash
+claude mcp add jujugrowth --scope user \
+  --env JUJUGROWTH_TOKEN=jgt_your_token_here \
+  -- npx -y jujugrowth-mcp
+```
+
+**Claude Desktop** (`claude_desktop_config.json`) / **Cursor** (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "jujugrowth": {
+      "command": "npx",
+      "args": ["-y", "jujugrowth-mcp"],
+      "env": { "JUJUGROWTH_TOKEN": "jgt_your_token_here" }
+    }
+  }
+}
+```
+
+The jujugrowth Settings → Developer panel generates the token and shows these
+commands pre-filled.
+
+3. Restart the client. You'll have three tools:
+   - `list_recommendations` — open recommendations across your businesses
+   - `get_recommendation` — the full brief for one (implement it in your repo)
+   - `mark_recommendation_handled` — mark it done after you've shipped it
+
+Requires Node ≥ 22. Optional env `JUJUGROWTH_API` (defaults to https://jujugrowth.com).

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "jujugrowth-mcp",
+  "version": "1.0.0",
+  "description": "MCP server connecting your AI coding assistant (Claude, Cursor, Codex) to jujugrowth — pull recommendations and apply them in your repo.",
+  "type": "module",
+  "bin": { "jujugrowth-mcp": "server.mjs" },
+  "files": ["server.mjs", "README.md"],
+  "engines": { "node": ">=22" },
+  "license": "UNLICENSED",
+  "publishConfig": { "access": "public" }
+}

package/server.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * jujugrowth MCP server (dependency-free stdio JSON-RPC, Node ≥ 22).
+ *
+ * Lets your dev-AI (Claude Desktop / Claude Code / Cursor) pull jujugrowth
+ * recommendations + their implementable briefs, and mark them handled — no
+ * copy-paste. jujugrowth stays read-only to your systems: this server only
+ * READS recommendations and WRITES status back to jujugrowth. The dev-AI does
+ * the actual code changes in YOUR repo, where you review them via git.
+ *
+ * Config (in your AI client's mcp settings):
+ *   command: node
+ *   args:    ["/abs/path/to/packages/mcp/server.mjs"]
+ *   env:     { "JUJUGROWTH_TOKEN": "jgt_…" }   // from Settings → Developer
+ * Optional env: JUJUGROWTH_API (default https://jujugrowth.com)
+ */
+
+const API = (process.env.JUJUGROWTH_API ?? "https://jujugrowth.com").replace(/\/+$/, "");
+const TOKEN = process.env.JUJUGROWTH_TOKEN ?? "";
+
+async function call(method, path, body) {
+  const res = await fetch(`${API}/api/mcp${path}`, {
+    method,
+    headers: {
+      authorization: `Bearer ${TOKEN}`,
+      ...(body ? { "content-type": "application/json" } : {}),
+    },
+    ...(body ? { body: JSON.stringify(body) } : {}),
+  });
+  const text = await res.text();
+  if (!res.ok) throw new Error(`jujugrowth ${res.status}: ${text.slice(0, 300)}`);
+  return text ? JSON.parse(text) : {};
+}
+
+const TOOLS = [
+  {
+    name: "list_recommendations",
+    description:
+      "List open jujugrowth recommendations across the businesses you can access. Returns id, tenantId, title, action_type, risk_class.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    run: async () => call("GET", "/recommendations"),
+  },
+  {
+    name: "get_recommendation",
+    description:
+      "Get the full implementable brief for one recommendation (title, body, and a ready-to-implement claude_prompt when present). Implement it in the user's repo, scoped to wording/structure/SEO — never touch checkout, auth, or analytics events.",
+    inputSchema: {
+      type: "object",
+      properties: { tenantId: { type: "string" }, recId: { type: "string" } },
+      required: ["tenantId", "recId"],
+      additionalProperties: false,
+    },
+    run: async (a) => call("GET", `/recommendations/${a.tenantId}/${a.recId}`),
+  },
+  {
+    name: "mark_recommendation_handled",
+    description:
+      "Mark a recommendation handled in jujugrowth (status → approved) AFTER you've implemented it in the user's repo. Writes back to jujugrowth only.",
+    inputSchema: {
+      type: "object",
+      properties: { tenantId: { type: "string" }, recId: { type: "string" } },
+      required: ["tenantId", "recId"],
+      additionalProperties: false,
+    },
+    run: async (a) => call("POST", `/recommendations/${a.tenantId}/${a.recId}/handled`),
+  },
+];
+
+function send(msg) {
+  process.stdout.write(`${JSON.stringify(msg)}\n`);
+}
+
+async function handle(msg) {
+  const { id, method, params } = msg;
+  if (method === "initialize") {
+    return send({
+      jsonrpc: "2.0",
+      id,
+      result: {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: { name: "jujugrowth", version: "1.0.0" },
+      },
+    });
+  }
+  if (method === "notifications/initialized") return; // no response to notifications
+  if (method === "tools/list") {
+    return send({
+      jsonrpc: "2.0",
+      id,
+      result: { tools: TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })) },
+    });
+  }
+  if (method === "tools/call") {
+    const tool = TOOLS.find((t) => t.name === params?.name);
+    if (!tool) return send({ jsonrpc: "2.0", id, error: { code: -32601, message: "unknown tool" } });
+    try {
+      if (!TOKEN) throw new Error("JUJUGROWTH_TOKEN not set — generate one in Settings → Developer");
+      const result = await tool.run(params.arguments ?? {});
+      return send({
+        jsonrpc: "2.0",
+        id,
+        result: { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] },
+      });
+    } catch (err) {
+      return send({
+        jsonrpc: "2.0",
+        id,
+        result: { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true },
+      });
+    }
+  }
+  if (id !== undefined) send({ jsonrpc: "2.0", id, error: { code: -32601, message: "method not found" } });
+}
+
+let buf = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => {
+  buf += chunk;
+  let nl;
+  while ((nl = buf.indexOf("\n")) >= 0) {
+    const line = buf.slice(0, nl).trim();
+    buf = buf.slice(nl + 1);
+    if (line) handle(JSON.parse(line)).catch((e) => process.stderr.write(`${e}\n`));
+  }
+});