@solongate/proxy 0.1.2 → 0.1.4

package/dist/create.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+
+// src/create.ts
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { resolve, join } from "path";
+import { execSync } from "child_process";
+function log(msg) {
+  process.stderr.write(msg + "\n");
+}
+function parseCreateArgs(argv) {
+  const args = argv.slice(2);
+  const opts = {
+    name: "",
+    policy: "restricted",
+    noInstall: false
+  };
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case "--policy":
+        opts.policy = args[++i];
+        break;
+      case "--no-install":
+        opts.noInstall = true;
+        break;
+      case "--help":
+      case "-h":
+        printHelp();
+        process.exit(0);
+        break;
+      default:
+        if (!args[i].startsWith("-") && !opts.name) {
+          opts.name = args[i];
+        }
+    }
+  }
+  if (!opts.name) {
+    log("");
+    log("  Error: Project name required.");
+    log("");
+    log("  Usage: npx @solongate/proxy create <name>");
+    log("");
+    log("  Examples:");
+    log("    npx @solongate/proxy create my-mcp-server");
+    log("    npx @solongate/proxy create weather-api");
+    process.exit(1);
+  }
+  return opts;
+}
+function printHelp() {
+  log(`
+SolonGate Create \u2014 Scaffold a secure MCP server in seconds
+
+USAGE
+  npx @solongate/proxy create <name> [options]
+
+OPTIONS
+  --policy <preset>   Policy preset (default: restricted)
+  --no-install        Skip dependency installation
+  -h, --help          Show this help message
+
+EXAMPLES
+  npx @solongate/proxy create my-server
+  npx @solongate/proxy create db-tools --policy read-only
+`);
+}
+function createProject(dir, name, _policy) {
+  writeFileSync(
+    join(dir, "package.json"),
+    JSON.stringify(
+      {
+        name,
+        version: "0.1.0",
+        type: "module",
+        private: true,
+        bin: { [name]: "./dist/index.js" },
+        scripts: {
+          build: "tsup src/index.ts --format esm",
+          dev: "tsx src/index.ts",
+          start: "node dist/index.js"
+        },
+        dependencies: {
+          "@modelcontextprotocol/sdk": "^1.26.0",
+          "@solongate/sdk": "latest",
+          zod: "^3.25.0"
+        },
+        devDependencies: {
+          tsup: "^8.3.0",
+          tsx: "^4.19.0",
+          typescript: "^5.7.0"
+        }
+      },
+      null,
+      2
+    ) + "\n"
+  );
+  writeFileSync(
+    join(dir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          esModuleInterop: true,
+          strict: true,
+          outDir: "dist",
+          rootDir: "src",
+          declaration: true,
+          skipLibCheck: true
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    ) + "\n"
+  );
+  mkdirSync(join(dir, "src"), { recursive: true });
+  writeFileSync(
+    join(dir, "src", "index.ts"),
+    `#!/usr/bin/env node
+
+// MCP uses stdout for JSON-RPC \u2014 redirect console to stderr
+console.log = (...args: unknown[]) => {
+  process.stderr.write(args.map(String).join(' ') + '\\n');
+};
+
+import { SecureMcpServer } from '@solongate/sdk';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+// Create a secure MCP server (API key from SOLONGATE_API_KEY env var)
+const server = new SecureMcpServer({
+  name: '${name}',
+  version: '0.1.0',
+});
+
+// \u2500\u2500 Register your tools below \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+server.tool(
+  'hello',
+  'Say hello to someone',
+  { name: z.string().describe('Name of the person to greet') },
+  async ({ name }) => ({
+    content: [{ type: 'text', text: \`Hello, \${name}! Welcome to ${name}.\` }],
+  }),
+);
+
+// Example: Add more tools here
+// server.tool(
+//   'read_data',
+//   'Read data from a source',
+//   { query: z.string().describe('What to read') },
+//   async ({ query }) => ({
+//     content: [{ type: 'text', text: \`Result for: \${query}\` }],
+//   }),
+// );
+
+// \u2500\u2500 Start the server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.log('${name} is running');
+`
+  );
+  writeFileSync(
+    join(dir, ".mcp.json"),
+    JSON.stringify(
+      {
+        mcpServers: {
+          [name]: {
+            command: "node",
+            args: ["dist/index.js"],
+            env: {
+              SOLONGATE_API_KEY: "sg_test_e4460d32_replace_with_your_key"
+            }
+          }
+        }
+      },
+      null,
+      2
+    ) + "\n"
+  );
+  writeFileSync(
+    join(dir, ".gitignore"),
+    `node_modules/
+dist/
+*.solongate-backup
+.env
+.env.local
+`
+  );
+}
+function withSpinner(message, fn) {
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let i = 0;
+  const id = setInterval(() => {
+    process.stderr.write(`\r  ${frames[i++ % frames.length]} ${message}`);
+  }, 80);
+  try {
+    fn();
+    clearInterval(id);
+    process.stderr.write(`\r  \u2713 ${message}
+`);
+  } catch {
+    clearInterval(id);
+    process.stderr.write(`\r  \u2717 ${message} \u2014 failed
+`);
+  }
+}
+function installDeps(dir) {
+  withSpinner("Installing dependencies...", () => {
+    execSync("npm install", { cwd: dir, stdio: "pipe" });
+  });
+}
+async function main() {
+  const opts = parseCreateArgs(process.argv);
+  const dir = resolve(opts.name);
+  log("");
+  log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+  log("  \u2551     SolonGate \u2014 Create MCP Server        \u2551");
+  log("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
+  log("");
+  if (existsSync(dir)) {
+    log(`  Error: Directory "${opts.name}" already exists.`);
+    process.exit(1);
+  }
+  mkdirSync(dir, { recursive: true });
+  log(`  Project:  ${opts.name}`);
+  log(`  Language: TypeScript`);
+  log(`  Policy:   ${opts.policy}`);
+  log("");
+  createProject(dir, opts.name, opts.policy);
+  log("  Files created:");
+  log("    package.json");
+  log("    tsconfig.json");
+  log("    src/index.ts");
+  log("    .mcp.json");
+  log("    .gitignore");
+  log("");
+  if (!opts.noInstall) {
+    installDeps(dir);
+    log("");
+  }
+  const W = 46;
+  const line = (s) => log(`  \u2502 ${s.padEnd(W)} \u2502`);
+  log(`  \u250C${"\u2500".repeat(W + 2)}\u2510`);
+  line("Project created!");
+  line("");
+  line(`cd ${opts.name}`);
+  line("");
+  line("npm run build     # Build");
+  line("npm run dev       # Dev mode (tsx)");
+  line("npm start         # Run built server");
+  line("");
+  line("Set your API key:");
+  line("export SOLONGATE_API_KEY=sg_live_xxx");
+  log(`  \u2514${"\u2500".repeat(W + 2)}\u2518`);
+  log("");
+}
+main().catch((err) => {
+  log(`Fatal: ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(1);
+});