create-better-t-stack 2.35.4 → 2.35.5-canary.869063df

package/README.md

@@ -45,6 +45,40 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | **Examples**             | • Todo app<br>• AI Chat interface (using Vercel AI SDK)                                                                                                                                                                                                    |
 | **Developer Experience** | • Automatic Git initialization<br>• Package manager choice (npm, pnpm, bun)<br>• Automatic dependency installation                                                                                                                                         |
 
+## MCP (Model Context Protocol) Support
+
+The CLI now supports the Model Context Protocol, allowing AI assistants to scaffold projects programmatically. This enables seamless integration with AI coding assistants like Claude, Cursor, and others.
+
+### Quick Start with MCP
+
+```bash
+# Start the MCP server
+npx create-better-t-stack --mcp
+```
+
+### MCP Client Configuration
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "better-t-stack": {
+      "command": "npx",
+      "args": ["-y", "create-better-t-stack", "--mcp"]
+    }
+  }
+}
+```
+
+### Available MCP Tools
+
+- **`create_project`** - Create a new Better-T Stack project with specified configuration
+- **`list_configurations`** - List all available configuration options
+- **`get_project_info`** - Get information about an existing project
+
+For detailed MCP documentation, see [MCP_README.md](./MCP_README.md).
+
 ## Usage
 
 ```bash

package/dist/cli.js

@@ -1,8 +1,426 @@
 #!/usr/bin/env node
-import { createBtsCli } from "./src-X-NzEC_t.js";
+import { createBtsCli, init } from "./src-BN1_H4yj.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
+//#region src/mcp-server.ts
+const server = new Server({
+	name: "create-better-t-stack",
+	version: "1.0.0"
+});
+const createProjectTool = {
+	name: "create_project",
+	description: "Create a new Better-T Stack project with the specified configuration",
+	inputSchema: {
+		type: "object",
+		properties: {
+			projectName: {
+				type: "string",
+				description: "Name of the project to create"
+			},
+			database: {
+				type: "string",
+				enum: [
+					"none",
+					"sqlite",
+					"postgres",
+					"mysql",
+					"mongodb"
+				],
+				description: "Database type to use"
+			},
+			orm: {
+				type: "string",
+				enum: [
+					"drizzle",
+					"prisma",
+					"mongoose",
+					"none"
+				],
+				description: "ORM to use"
+			},
+			backend: {
+				type: "string",
+				enum: [
+					"hono",
+					"express",
+					"fastify",
+					"next",
+					"elysia",
+					"convex",
+					"none"
+				],
+				description: "Backend framework to use"
+			},
+			runtime: {
+				type: "string",
+				enum: [
+					"bun",
+					"node",
+					"workers",
+					"none"
+				],
+				description: "Runtime environment"
+			},
+			frontend: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"tanstack-router",
+						"react-router",
+						"tanstack-start",
+						"next",
+						"nuxt",
+						"native-nativewind",
+						"native-unistyles",
+						"svelte",
+						"solid",
+						"none"
+					]
+				},
+				description: "Frontend frameworks to use"
+			},
+			addons: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"pwa",
+						"tauri",
+						"starlight",
+						"biome",
+						"husky",
+						"ruler",
+						"turborepo",
+						"fumadocs",
+						"ultracite",
+						"oxlint",
+						"none"
+					]
+				},
+				description: "Addons to include"
+			},
+			examples: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"todo",
+						"ai",
+						"none"
+					]
+				},
+				description: "Example templates to include"
+			},
+			auth: {
+				type: "boolean",
+				description: "Whether to include authentication"
+			},
+			git: {
+				type: "boolean",
+				description: "Whether to initialize git repository"
+			},
+			packageManager: {
+				type: "string",
+				enum: [
+					"npm",
+					"pnpm",
+					"bun"
+				],
+				description: "Package manager to use"
+			},
+			install: {
+				type: "boolean",
+				description: "Whether to install dependencies"
+			},
+			dbSetup: {
+				type: "string",
+				enum: [
+					"turso",
+					"neon",
+					"prisma-postgres",
+					"mongodb-atlas",
+					"supabase",
+					"d1",
+					"docker",
+					"none"
+				],
+				description: "Database setup configuration"
+			},
+			api: {
+				type: "string",
+				enum: [
+					"trpc",
+					"orpc",
+					"none"
+				],
+				description: "API type to use"
+			},
+			webDeploy: {
+				type: "string",
+				enum: [
+					"vercel",
+					"netlify",
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				description: "Web deployment platform"
+			},
+			serverDeploy: {
+				type: "string",
+				enum: [
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				description: "Server deployment platform"
+			},
+			directoryConflict: {
+				type: "string",
+				enum: [
+					"merge",
+					"overwrite",
+					"increment",
+					"error"
+				],
+				description: "How to handle directory conflicts"
+			},
+			yes: {
+				type: "boolean",
+				description: "Use default configuration without prompts"
+			},
+			yolo: {
+				type: "boolean",
+				description: "Bypass validations and compatibility checks"
+			},
+			verbose: {
+				type: "boolean",
+				description: "Show detailed result information"
+			},
+			disableAnalytics: {
+				type: "boolean",
+				description: "Disable analytics"
+			}
+		},
+		required: ["projectName"]
+	}
+};
+const listConfigurationsTool = {
+	name: "list_configurations",
+	description: "List available configurations for Better-T Stack projects",
+	inputSchema: {
+		type: "object",
+		properties: {}
+	}
+};
+const getProjectInfoTool = {
+	name: "get_project_info",
+	description: "Get information about a Better-T Stack project",
+	inputSchema: {
+		type: "object",
+		properties: { projectPath: {
+			type: "string",
+			description: "Path to the project directory"
+		} },
+		required: ["projectPath"]
+	}
+};
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+	return { tools: [
+		createProjectTool,
+		listConfigurationsTool,
+		getProjectInfoTool
+	] };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+	const { name, arguments: args } = request.params;
+	switch (name) {
+		case "create_project": try {
+			const projectConfig = {
+				projectName: args?.projectName,
+				database: args?.database,
+				orm: args?.orm,
+				backend: args?.backend,
+				runtime: args?.runtime,
+				frontend: args?.frontend,
+				addons: args?.addons,
+				examples: args?.examples,
+				auth: args?.auth,
+				git: args?.git,
+				packageManager: args?.packageManager,
+				install: args?.install,
+				dbSetup: args?.dbSetup,
+				api: args?.api,
+				webDeploy: args?.webDeploy,
+				serverDeploy: args?.serverDeploy,
+				directoryConflict: args?.directoryConflict,
+				yes: args?.yes,
+				yolo: args?.yolo,
+				verbose: args?.verbose,
+				disableAnalytics: args?.disableAnalytics
+			};
+			const result = await init(args?.projectName, projectConfig);
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 2)
+			}] };
+		} catch (error) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error creating project: ${error instanceof Error ? error.message : String(error)}`
+				}],
+				isError: true
+			};
+		}
+		case "list_configurations": {
+			const configurations = {
+				databases: [
+					"none",
+					"sqlite",
+					"postgres",
+					"mysql",
+					"mongodb"
+				],
+				orms: [
+					"drizzle",
+					"prisma",
+					"mongoose",
+					"none"
+				],
+				backends: [
+					"hono",
+					"express",
+					"fastify",
+					"next",
+					"elysia",
+					"convex",
+					"none"
+				],
+				runtimes: [
+					"bun",
+					"node",
+					"workers",
+					"none"
+				],
+				frontends: [
+					"tanstack-router",
+					"react-router",
+					"tanstack-start",
+					"next",
+					"nuxt",
+					"native-nativewind",
+					"native-unistyles",
+					"svelte",
+					"solid",
+					"none"
+				],
+				addons: [
+					"pwa",
+					"tauri",
+					"starlight",
+					"biome",
+					"husky",
+					"ruler",
+					"turborepo",
+					"fumadocs",
+					"ultracite",
+					"oxlint",
+					"none"
+				],
+				examples: [
+					"todo",
+					"ai",
+					"none"
+				],
+				packageManagers: [
+					"npm",
+					"pnpm",
+					"bun"
+				],
+				dbSetups: [
+					"turso",
+					"neon",
+					"prisma-postgres",
+					"mongodb-atlas",
+					"supabase",
+					"d1",
+					"docker",
+					"none"
+				],
+				apis: [
+					"trpc",
+					"orpc",
+					"none"
+				],
+				webDeploys: [
+					"vercel",
+					"netlify",
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				serverDeploys: [
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				directoryConflicts: [
+					"merge",
+					"overwrite",
+					"increment",
+					"error"
+				]
+			};
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(configurations, null, 2)
+			}] };
+		}
+		case "get_project_info": try {
+			return { content: [{
+				type: "text",
+				text: "Project info functionality not yet implemented"
+			}] };
+		} catch (error) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error getting project info: ${error instanceof Error ? error.message : String(error)}`
+				}],
+				isError: true
+			};
+		}
+		default: throw new Error(`Unknown tool: ${name}`);
+	}
+});
+async function startMCPServer() {
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	console.error("Better-T Stack MCP server started");
+}
+async function main$1() {
+	await startMCPServer();
+}
+if (import.meta.url === `file://${process.argv[1]}`) main$1().catch((error) => {
+	console.error("MCP server error:", error);
+	process.exit(1);
+});
+
+//#endregion
 //#region src/cli.ts
-createBtsCli().run();
+async function main() {
+	const args = process.argv.slice(2);
+	if (args.includes("--mcp")) await startMCPServer();
+	else createBtsCli().run();
+}
+main().catch((error) => {
+	console.error("CLI error:", error);
+	process.exit(1);
+});
 
 //#endregion
 export {  };

package/dist/index.d.ts

@@ -134,6 +134,7 @@ type CreateInput = {
   directoryConflict?: DirectoryConflict;
   renderTitle?: boolean;
   disableAnalytics?: boolean;
+  mcp?: boolean;
 };
 type AddInput = {
   addons?: Addons[];
@@ -221,6 +222,7 @@ declare const router: trpcServer.TRPCBuiltRouter<{
       directoryConflict?: "error" | "merge" | "overwrite" | "increment" | undefined;
       renderTitle?: boolean | undefined;
       disableAnalytics?: boolean | undefined;
+      mcp?: boolean | undefined;
     }];
     output: InitResult | undefined;
     meta: object;

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { builder, createBtsCli, docs, init, router, sponsors } from "./src-X-NzEC_t.js";
+import { builder, createBtsCli, docs, init, router, sponsors } from "./src-BN1_H4yj.js";
 
 export { builder, createBtsCli, docs, init, router, sponsors };

package/dist/{src-X-NzEC_t.js → src-BN1_H4yj.js}

@@ -1080,7 +1080,8 @@ async function getServerDeploymentChoice(deployment, runtime, backend, webDeploy
 	if (backend === "none" || backend === "convex") return "none";
 	if (backend !== "hono") return "none";
 	const options = [];
-	if (runtime === "workers") ["alchemy", "wrangler"].forEach((deploy) => {
+	if (runtime !== "workers") return "none";
+	["alchemy", "wrangler"].forEach((deploy) => {
 		const { label, hint } = getDeploymentDisplay$1(deploy);
 		options.unshift({
 			value: deploy,
@@ -1088,11 +1089,6 @@ async function getServerDeploymentChoice(deployment, runtime, backend, webDeploy
 			hint
 		});
 	});
-	else options.push({
-		value: "none",
-		label: "None",
-		hint: "Manual setup"
-	});
 	const response = await select({
 		message: "Select server deployment",
 		options,
@@ -1123,11 +1119,7 @@ async function getServerDeploymentToAdd(runtime, existingDeployment, backend) {
 		}
 	}
 	if (existingDeployment && existingDeployment !== "none") return "none";
-	if (options.length > 0) options.push({
-		value: "none",
-		label: "None",
-		hint: "Skip deployment setup"
-	});
+	if (options.length > 0) {}
 	if (options.length === 0) return "none";
 	const response = await select({
 		message: "Select server deployment",
@@ -1353,7 +1345,7 @@ const getLatestCLIVersion = () => {
 */
 function isTelemetryEnabled() {
 	const BTS_TELEMETRY_DISABLED = process.env.BTS_TELEMETRY_DISABLED;
-	const BTS_TELEMETRY = "1";
+	const BTS_TELEMETRY = "0";
 	if (BTS_TELEMETRY_DISABLED !== void 0) return BTS_TELEMETRY_DISABLED !== "1";
 	if (BTS_TELEMETRY !== void 0) return BTS_TELEMETRY === "1";
 	return true;
@@ -1361,8 +1353,8 @@ function isTelemetryEnabled() {
 
 //#endregion
 //#region src/utils/analytics.ts
-const POSTHOG_API_KEY = "phc_8ZUxEwwfKMajJLvxz1daGd931dYbQrwKNficBmsdIrs";
-const POSTHOG_HOST = "https://us.i.posthog.com";
+const POSTHOG_API_KEY = "random";
+const POSTHOG_HOST = "random";
 function generateSessionId() {
 	const rand = Math.random().toString(36).slice(2);
 	const now = Date.now().toString(36);
@@ -1740,6 +1732,7 @@ function validateFullConfig(config, providedFlags, options) {
 	validateApiConstraints(config, options);
 	validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
 	validateWorkersCompatibility(providedFlags, options, config);
+	if (config.runtime === "workers" && config.serverDeploy === "none") exitWithError("Cloudflare Workers runtime requires a server deployment. Please choose 'wrangler' or 'alchemy' for --server-deploy.");
 	if (config.addons && config.addons.length > 0) {
 		validateAddonsAgainstFrontends(config.addons, config.frontend);
 		config.addons = [...new Set(config.addons)];
@@ -6327,7 +6320,8 @@ const router = t.router({
 		serverDeploy: ServerDeploySchema.optional(),
 		directoryConflict: DirectoryConflictSchema.optional(),
 		renderTitle: z.boolean().optional(),
-		disableAnalytics: z.boolean().optional().default(false).describe("Disable analytics")
+		disableAnalytics: z.boolean().optional().default(false).describe("Disable analytics"),
+		mcp: z.boolean().optional().default(false).describe("Start as MCP server")
 	})])).mutation(async ({ input }) => {
 		const [projectName, options] = input;
 		const combinedInput = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.35.4",
+  "version": "2.35.5-canary.869063df",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",
@@ -67,6 +67,7 @@
     "@biomejs/js-api": "^3.0.0",
     "@biomejs/wasm-nodejs": "^2.2.0",
     "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/sdk": "^0.4.0",
     "consola": "^3.4.2",
     "execa": "^9.6.0",
     "fs-extra": "^11.3.1",