create-futurity-plugin 1.0.0

package/index.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env bun
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { resolve, basename } from "node:path";
+import { execSync } from "node:child_process";
+
+const arg = process.argv[2];
+
+if (!arg) {
+  console.error("Usage: bun create futurity-plugin <project-name>");
+  console.error("       bun create futurity-plugin .  (scaffold in current directory)");
+  process.exit(1);
+}
+
+const isCwd = arg === ".";
+const targetDir = isCwd ? process.cwd() : resolve(process.cwd(), arg);
+const projectName = isCwd ? basename(process.cwd()) : arg;
+
+if (!isCwd) {
+  if (existsSync(targetDir)) {
+    console.error(`Error: Directory "${arg}" already exists.`);
+    process.exit(1);
+  }
+  mkdirSync(targetDir, { recursive: true });
+}
+
+// Copy template files
+const templateDir = resolve(import.meta.dirname, "template");
+cpSync(templateDir, targetDir, { recursive: true });
+
+// Process package.json template
+const pkgPath = resolve(targetDir, "package.json.tmpl");
+const pkgContent = readFileSync(pkgPath, "utf-8");
+writeFileSync(
+  resolve(targetDir, "package.json"),
+  pkgContent.replace(/\{\{name\}\}/g, projectName)
+);
+unlinkSync(pkgPath);
+
+// Install dependencies
+console.log(`\nScaffolding ${projectName}...\n`);
+execSync("bun install", { cwd: targetDir, stdio: "inherit" });
+
+console.log(`\n✅ Created ${projectName}\n`);
+console.log("Next steps:\n");
+if (!isCwd) {
+  console.log(`  cd ${arg}`);
+}
+console.log("  bun run src/index.ts\n");

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "create-futurity-plugin",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Scaffold a new Futurity MCP plugin",
+  "author": "Futurity",
+  "license": "MIT",
+  "bin": {
+    "create-futurity-plugin": "./index.ts"
+  },
+  "scripts": {
+    "test": "echo 'No tests'"
+  },
+  "files": ["index.ts", "template"],
+  "keywords": [
+    "create",
+    "scaffold",
+    "mcp",
+    "futurity",
+    "plugin"
+  ]
+}

package/template/package.json.tmpl

@@ -0,0 +1,18 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts"
+  },
+  "dependencies": {
+    "@futurity/plugins": "^2.0.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@types/bun": "latest",
+    "typescript": "^5.9.3",
+    "zod": "^4.1.13"
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,16 @@
+import { mcp, t } from "@futurity/plugins";
+
+const app = mcp({
+  name: "my-plugin",
+  version: "0.1.0",
+});
+
+app.tool("hello", {
+  description: "Say hello",
+  input: t.obj({ name: t.str }),
+  handler: async ({ name }) => ({
+    greeting: `Hello, ${name}!`,
+  }),
+});
+
+await app.listen(3000);

package/template/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "allowJs": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "strict": true,
+    "skipLibCheck": true
+  }
+}