@manturhub/cli 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# @manturhub/cli
+
+ManturHub 算子广场命令行工具。两件事:
+
+1. **命令行直调算子** —— 不写代码、不碰 MCP,终端一行调用 AI 算子。
+2. **stdio MCP server** —— 给 Claude Code / Codex / Cursor / Claude Desktop 等当本地 MCP server。stdio 是所有 AI 客户端都稳定支持的传输,装上这个 CLI 就一行接入,绕开各家对远程传输支持参差的坑。
+
+## 安装
+
+```bash
+npm install -g @manturhub/cli
+# 或免安装直接用: npx -y @manturhub/cli <命令>
+```
+
+需要 Node.js ≥ 18。
+
+## 上手三步
+
+```bash
+# 1. 配 Key（去 https://manturhub.leisurecat.cloud/dashboard 拿）
+manturhub login --key sk-你的key
+
+# 2. 验证（列出全部上线算子）
+manturhub ls
+
+# 3. 调一个算子试试
+manturhub run op.text.commerce-copy --json '{"product_info":"便携榨汁杯,USB充电,300ml","scene":"product_title","tone":"lively"}'
+```
+
+## 把算子接进你的 AI（stdio，一行搞定）
+
+**Codex** — `~/.codex/config.toml`:
+```toml
+[mcp_servers.manturhub]
+command = "manturhub"
+args = ["mcp"]
+env = { MANTURHUB_KEY = "sk-你的key" }
+```
+
+**Claude Desktop / Cursor / Cline**:
+```json
+{ "mcpServers": { "manturhub": { "command": "manturhub", "args": ["mcp"] } } }
+```
+
+装好后,AI 就能直接 `list_operators` 看平台能力、`run_operator` 调用算子。只想要某个业务域?加 `--scope`:
+```toml
+args = ["mcp", "--scope", "drama"]   # 只暴露剧本域算子
+```
+域可选: `manturhub`(全部) · `drama`(剧本) · `production`(制片) · `ecom-video`(电商视频)。
+
+## 命令
+
+| 命令 | 说明 |
+|---|---|
+| `manturhub login --key sk-xxx` | 配置并验证 API Key（存 `~/.manturhub/config.json`,600 权限） |
+| `manturhub mcp [--scope <域>]` | 启动 stdio MCP server（被 AI 客户端作为子进程拉起） |
+| `manturhub ls [--cat <分类>]` | 列出上线算子 |
+| `manturhub run <算子ID> --json '{}'` | 调用算子（也支持 `--字段 值` 形式） |
+| `manturhub balance` | 查询馒头余额 |
+
+环境变量: `MANTURHUB_KEY`(API Key,优先于配置文件) · `MANTURHUB_BASE`(网关地址)。
+
+## 它是怎么工作的
+
+`manturhub mcp` 不重新实现 MCP server,而是把客户端的 stdio JSON-RPC 消息转发到 ManturHub 已标准化的 Streamable HTTP MCP 端点(`/api/v1/mcp/<域>/mcp`),再把响应写回 stdout。工具发现、调用、计费全部在服务端完成,CLI 只做可靠的 stdio↔HTTP 桥接 —— 等于一个官方、可控的 mcp-remote。
+
+---
+ManturHub 算子广场 · https://manturhub.leisurecat.cloud

package/bin/cli.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import { saveConfig, loadConfig } from "../lib/config.js";
+import { apiFetch } from "../lib/api.js";
+import { runMcpBridge } from "../lib/mcp.js";
+
+const VERSION = "0.1.0";
+const args = process.argv.slice(2);
+const cmd = args[0];
+
+function getFlag(name, def) {
+  const i = args.indexOf(`--${name}`);
+  return i >= 0 && args[i + 1] !== undefined ? args[i + 1] : def;
+}
+
+const HELP = `manturhub — ManturHub 算子广场 CLI  v${VERSION}
+
+用法:
+  manturhub login --key sk-xxx        配置 API Key（存 ~/.manturhub/config.json）
+  manturhub mcp [--scope <域>]        启动 stdio MCP server（给 Claude Code / Codex / Cursor 等）
+                                      域: manturhub(全部) | drama | production | ecom-video
+  manturhub ls [--cat <分类>]         列出上线算子（分类: text/image/video/audio/data）
+  manturhub run <算子ID> --json '{}'  调用算子（也可用 --字段 值 形式）
+  manturhub balance                   查询馒头余额
+  manturhub help | --version
+
+环境变量:
+  MANTURHUB_KEY    API Key（优先于配置文件）
+  MANTURHUB_BASE   网关地址（默认 https://manturhub.leisurecat.cloud）
+
+把算子接进你的 AI（stdio，所有客户端都稳）:
+  Codex  ~/.codex/config.toml:
+    [mcp_servers.manturhub]
+    command = "manturhub"
+    args = ["mcp"]
+    env = { MANTURHUB_KEY = "sk-xxx" }
+
+  Claude Desktop / Cursor:
+    { "mcpServers": { "manturhub": { "command": "manturhub", "args": ["mcp"] } } }
+`;
+
+async function main() {
+  switch (cmd) {
+    case "login": {
+      const key = getFlag("key");
+      if (!key) {
+        console.error("用法: manturhub login --key sk-xxx");
+        process.exit(1);
+      }
+      const cfg = loadConfig();
+      cfg.key = key;
+      saveConfig(cfg);
+      const r = await apiFetch("/api/v1/me", { key });
+      if (r.ok) {
+        console.log(
+          `✓ Key 已保存。账号: ${r.json.email || "-"}   余额: ${r.json.balance ?? "-"} 馒头`
+        );
+      } else {
+        console.log(
+          `✓ Key 已保存，但验证失败（HTTP ${r.status}）。请确认 key 是否正确、是否已激活。`
+        );
+      }
+      break;
+    }
+
+    case "mcp": {
+      await runMcpBridge({ scope: getFlag("scope", "manturhub") });
+      break;
+    }
+
+    case "ls": {
+      const cat = getFlag("cat");
+      const r = await apiFetch("/api/v1/operators?status=online");
+      if (!r.ok) {
+        console.error(`列表获取失败（HTTP ${r.status}）`);
+        process.exit(1);
+      }
+      let ops = r.json.operators || r.json || [];
+      if (cat) ops = ops.filter((o) => o.cat === cat);
+      console.log(`ManturHub 上线算子（${ops.length} 个）:\n`);
+      for (const o of ops) {
+        console.log(`  ${o.id.padEnd(26)} ${o.name}   [${o.cat}]`);
+      }
+      console.log(`\n用 \`manturhub run <算子ID> --json '{...}'\` 调用，参数见 ${"https://manturhub.leisurecat.cloud"}/marketplace/<算子ID>`);
+      break;
+    }
+
+    case "run": {
+      const op = args[1];
+      if (!op || op.startsWith("--")) {
+        console.error("用法: manturhub run <算子ID> --json '{...}'   或   --字段 值");
+        process.exit(1);
+      }
+      let body = {};
+      const jsonArg = getFlag("json");
+      if (jsonArg) {
+        try {
+          body = JSON.parse(jsonArg);
+        } catch {
+          console.error("--json 参数不是合法 JSON");
+          process.exit(1);
+        }
+      } else {
+        for (let i = 2; i < args.length; i += 2) {
+          if (args[i] && args[i].startsWith("--") && args[i + 1] !== undefined) {
+            body[args[i].slice(2)] = args[i + 1];
+          }
+        }
+      }
+      const r = await apiFetch(
+        `/api/v1/operators/${encodeURIComponent(op)}/invoke`,
+        { method: "POST", body }
+      );
+      console.log(JSON.stringify(r.json, null, 2));
+      if (!r.ok) process.exit(1);
+      break;
+    }
+
+    case "balance": {
+      const r = await apiFetch("/api/v1/me");
+      if (!r.ok) {
+        console.error(`查询失败（HTTP ${r.status}）`);
+        process.exit(1);
+      }
+      console.log(
+        `馒头余额: ${r.json.balance ?? "-"}   账号: ${r.json.email || "-"}`
+      );
+      break;
+    }
+
+    case "--version":
+    case "-v":
+      console.log(VERSION);
+      break;
+
+    case "help":
+    case "--help":
+    case "-h":
+    case undefined:
+      console.log(HELP);
+      break;
+
+    default:
+      console.error(`未知命令: ${cmd}\n`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}
+
+main().catch((e) => {
+  console.error("错误:", e.message);
+  process.exit(1);
+});

package/lib/api.js

@@ -0,0 +1,27 @@
+import { getKey, getBaseUrl } from "./config.js";
+
+// Thin REST client against the ManturHub gateway. Every call carries x-api-key.
+export async function apiFetch(path, { method = "GET", body, key } = {}) {
+  const apiKey = key || getKey();
+  if (!apiKey) {
+    throw new Error(
+      "未配置 API Key。运行 `manturhub login --key sk-xxx`，或设置环境变量 MANTURHUB_KEY。"
+    );
+  }
+  const res = await fetch(getBaseUrl() + path, {
+    method,
+    headers: {
+      "x-api-key": apiKey,
+      ...(body ? { "Content-Type": "application/json" } : {}),
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  });
+  const text = await res.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    json = text;
+  }
+  return { ok: res.ok, status: res.status, json };
+}

package/lib/config.js

@@ -0,0 +1,40 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import {
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+  existsSync,
+  chmodSync,
+} from "node:fs";
+
+// Local config lives at ~/.manturhub/config.json (chmod 600). Env vars win over it.
+const DIR = join(homedir(), ".manturhub");
+const FILE = join(DIR, "config.json");
+const DEFAULT_BASE = "https://manturhub.leisurecat.cloud";
+
+export function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(cfg) {
+  if (!existsSync(DIR)) mkdirSync(DIR, { recursive: true });
+  writeFileSync(FILE, JSON.stringify(cfg, null, 2));
+  try {
+    chmodSync(FILE, 0o600);
+  } catch {
+    /* best-effort on platforms without chmod */
+  }
+}
+
+export function getKey() {
+  return process.env.MANTURHUB_KEY || loadConfig().key || null;
+}
+
+export function getBaseUrl() {
+  return process.env.MANTURHUB_BASE || loadConfig().baseUrl || DEFAULT_BASE;
+}

package/lib/mcp.js

@@ -0,0 +1,108 @@
+import { createInterface } from "node:readline";
+import { getKey, getBaseUrl } from "./config.js";
+
+// `manturhub mcp` — a stdio MCP server for clients (Claude Desktop / Codex /
+// Cursor …) that only speak stdio or whose remote-transport support is immature.
+//
+// It does NOT reimplement the MCP server: it relays each newline-delimited
+// JSON-RPC message from stdin to the remote ManturHub Streamable HTTP endpoint
+// (already standard-compliant) and writes the HTTP response back to stdout.
+// The remote handles initialize / tools/list / tools/call / scope. This is an
+// official, controlled equivalent of mcp-remote.
+export async function runMcpBridge({ scope = "manturhub" } = {}) {
+  const key = getKey();
+  if (!key) {
+    process.stderr.write(
+      "[manturhub mcp] 未配置 API Key。运行 `manturhub login --key sk-xxx`，或设 MANTURHUB_KEY。\n"
+    );
+    process.exit(1);
+  }
+  const url = `${getBaseUrl()}/api/v1/mcp/${scope}/mcp`;
+  const rl = createInterface({ input: process.stdin });
+
+  // Track in-flight relays so we don't exit on stdin close while a fetch is
+  // still pending (real clients keep stdin open; piped input closes early).
+  let pending = 0;
+  let closed = false;
+  const maybeExit = () => {
+    if (closed && pending === 0) process.exit(0);
+  };
+
+  rl.on("line", (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+    let msg;
+    try {
+      msg = JSON.parse(trimmed);
+    } catch {
+      return; // exactly one JSON value per line; ignore noise
+    }
+    pending++;
+    relay(url, key, msg).finally(() => {
+      pending--;
+      maybeExit();
+    });
+  });
+
+  rl.on("close", () => {
+    closed = true;
+    maybeExit();
+  });
+}
+
+async function relay(url, key, msg) {
+  try {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+        "x-api-key": key,
+        "MCP-Protocol-Version": "2025-06-18",
+      },
+      body: JSON.stringify(msg),
+    });
+
+    // 202 Accepted = notification/response acknowledged, no body to relay.
+    if (res.status === 202) return;
+
+    const ctype = res.headers.get("content-type") || "";
+    const text = await res.text();
+    if (!text) return;
+
+    if (ctype.includes("text/event-stream")) {
+      // Defensive: if the remote ever streams SSE, pull JSON-RPC from data: lines.
+      for (const evt of text.split(/\n\n/)) {
+        const data = evt
+          .split("\n")
+          .filter((l) => l.startsWith("data:"))
+          .map((l) => l.slice(5).trim())
+          .join("");
+        if (data) writeFrame(data);
+      }
+      return;
+    }
+
+    // Normal case: remote returns a single application/json JSON-RPC response.
+    writeFrame(text);
+  } catch (err) {
+    // Transport failure → return a JSON-RPC error for this id (requests only).
+    if (msg.id !== undefined && msg.id !== null) {
+      writeFrame(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          id: msg.id,
+          error: {
+            code: -32603,
+            message: "manturhub bridge: " + (err?.message || "upstream error"),
+          },
+        })
+      );
+    }
+  }
+}
+
+// One JSON value per line (stdio framing). Collapse raw newlines so framing holds.
+function writeFrame(jsonText) {
+  process.stdout.write(jsonText.replace(/\r?\n/g, " ") + "\n");
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@manturhub/cli",
+  "version": "0.1.0",
+  "description": "ManturHub 算子广场 CLI：命令行直调 AI 算子 + 给 Claude Code / Codex / Cursor 等当 stdio MCP server",
+  "type": "module",
+  "bin": {
+    "manturhub": "./bin/cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "manturhub",
+    "mcp",
+    "ai",
+    "cli",
+    "operator",
+    "算子",
+    "stdio"
+  ],
+  "license": "MIT",
+  "homepage": "https://manturhub.leisurecat.cloud"
+}