create-mcp-use-app 2.0.0-beta.0 → 2.0.0-beta.2

package/README.md

@@ -433,7 +433,7 @@ server.prompt("code_review", {
 **Command not found:**
 
 ```bash
-# Make sure you have Node.js 20.19+ installed
+# Make sure you have Node.js 22.22.2+ installed
 node --version
 
 # Try with npx

package/dist/index.js

@@ -1346,7 +1346,7 @@ function parseCli(argv) {
       install: { type: "boolean" },
       skills: { type: "boolean" },
       dev: { type: "boolean" },
-      canary: { type: "boolean" },
+      "sdk-version": { type: "string" },
       yarn: { type: "boolean" },
       npm: { type: "boolean" },
       pnpm: { type: "boolean" },
@@ -1366,7 +1366,7 @@ function parseCli(argv) {
       install,
       skills,
       dev: values.dev,
-      canary: values.canary,
+      sdkVersion: values["sdk-version"],
       yarn: values.yarn,
       npm: values.npm,
       pnpm: values.pnpm
@@ -1539,32 +1539,13 @@ function renderLogo() {
 var packageJson = JSON.parse(
   readFileSync2(join3(__dirname, "../package.json"), "utf-8")
 );
-function getCurrentPackageVersions(isDevelopment = false, useCanary = false) {
-  const versions = {};
-  try {
-    if (isDevelopment) {
-      versions["mcp-use"] = "workspace:*";
-    } else if (useCanary) {
-      versions["mcp-use"] = "canary";
-    } else {
-      versions["mcp-use"] = "latest";
-    }
-  } catch (error) {
-    if (process.env.NODE_ENV === "development") {
-      console.warn(
-        "\u26A0\uFE0F  Could not read workspace package versions, using defaults"
-      );
-      console.warn(
-        `   Error: ${error instanceof Error ? error.message : String(error)}`
-      );
-      if (error instanceof Error && error.stack) {
-        console.warn(`   Stack: ${error.stack}`);
-      }
-    }
+function getCurrentPackageVersions(isDevelopment = false, sdkVersion) {
+  if (isDevelopment) {
+    return { "mcp-use": "workspace:*" };
   }
-  return versions;
+  return { "mcp-use": sdkVersion ?? "latest" };
 }
-function processTemplateFile(filePath, versions, isDevelopment = false, useCanary = false) {
+function processTemplateFile(filePath, versions, isDevelopment = false) {
   const content = readFileSync2(filePath, "utf-8");
   let processedContent = content;
   for (const [packageName, version] of Object.entries(versions)) {
@@ -1574,24 +1555,20 @@ function processTemplateFile(filePath, versions, isDevelopment = false, useCanar
       version
     );
   }
+  const mcpUseVersion = isDevelopment ? "workspace:*" : versions["mcp-use"] || "latest";
   if (isDevelopment) {
     processedContent = processedContent.replace(
       /"mcp-use": "\^[^"]+"/,
       '"mcp-use": "workspace:*"'
     );
-  } else if (useCanary) {
+  } else {
     processedContent = processedContent.replace(
       /"mcp-use": "workspace:\*"/,
-      `"mcp-use": "canary"`
+      `"mcp-use": "${mcpUseVersion}"`
     );
     processedContent = processedContent.replace(
       /"mcp-use": "\^[^"]+"/,
-      `"mcp-use": "canary"`
-    );
-  } else {
-    processedContent = processedContent.replace(
-      /"mcp-use": "workspace:\*"/,
-      `"mcp-use": "${versions["mcp-use"] || "latest"}"`
+      `"mcp-use": "${mcpUseVersion}"`
     );
   }
   return processedContent;
@@ -1779,7 +1756,7 @@ function validateTemplateName(template) {
   }
   return resolvedTemplate;
 }
-async function copyTemplate(projectPath, template, versions, isDevelopment = false, useCanary = false) {
+async function copyTemplate(projectPath, template, versions, isDevelopment = false) {
   const repoInfo = parseGitHubRepoUrl(template);
   if (repoInfo) {
     const tempDir = mkdtempSync(join3(tmpdir(), "create-mcp-use-app-"));
@@ -1789,8 +1766,7 @@ async function copyTemplate(projectPath, template, versions, isDevelopment = fal
         tempDir,
         projectPath,
         versions,
-        isDevelopment,
-        useCanary
+        isDevelopment
       );
     } finally {
       try {
@@ -1832,11 +1808,10 @@ async function copyTemplate(projectPath, template, versions, isDevelopment = fal
     templatePath,
     projectPath,
     versions,
-    isDevelopment,
-    useCanary
+    isDevelopment
   );
 }
-function copyDirectoryWithProcessing(src, dest, versions, isDevelopment, useCanary = false) {
+function copyDirectoryWithProcessing(src, dest, versions, isDevelopment) {
   const entries = readdirSync3(src, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.name === ".git") {
@@ -1847,19 +1822,12 @@ function copyDirectoryWithProcessing(src, dest, versions, isDevelopment, useCana
     const destPath = join3(dest, destName);
     if (entry.isDirectory()) {
       mkdirSync(destPath, { recursive: true });
-      copyDirectoryWithProcessing(
-        srcPath,
-        destPath,
-        versions,
-        isDevelopment,
-        useCanary
-      );
+      copyDirectoryWithProcessing(srcPath, destPath, versions, isDevelopment);
     } else if (entry.name === "package.json" || entry.name.endsWith(".json")) {
       const processedContent = processTemplateFile(
         srcPath,
         versions,
-        isDevelopment,
-        useCanary
+        isDevelopment
       );
       writeFileSync2(destPath, processedContent);
     } else {
@@ -1946,7 +1914,7 @@ Options:
   --no-skills               Skip installing skills
   --no-git                  Skip initializing a git repository
   --dev                     Use workspace dependencies for development
-  --canary                  Use canary versions of packages
+  --sdk-version <version>   Pin mcp-use to an npm version or dist-tag (e.g. canary, 1.34.0)
   --yarn                    Use yarn as package manager
   --npm                     Use npm as package manager
   --pnpm                    Use pnpm as package manager
@@ -1968,11 +1936,15 @@ async function main() {
     listTemplates();
     return;
   }
-  if (options.dev && options.canary) {
-    console.error(red("\u274C Cannot use --dev and --canary together"));
+  if (options.dev && options.sdkVersion) {
+    console.error(red("\u274C Cannot use --dev and --sdk-version together"));
     console.error(yellow("   Please choose only one dependency mode"));
     process.exit(1);
   }
+  if (options.sdkVersion !== void 0 && !options.sdkVersion.trim()) {
+    console.error(red("\u274C --sdk-version requires a non-empty value"));
+    process.exit(1);
+  }
   let projectName = initialProjectName;
   let selectedTemplate = options.template;
   const interactive = isInteractive();
@@ -2059,14 +2031,8 @@ async function main() {
   }
   console.log(cyan(`\u{1F680} Creating MCP server "${displayName}"...`));
   const validatedTemplate = validateTemplateName(selectedTemplate);
-  const versions = getCurrentPackageVersions(options.dev, options.canary);
-  await copyTemplate(
-    projectPath,
-    validatedTemplate,
-    versions,
-    options.dev,
-    options.canary
-  );
+  const versions = getCurrentPackageVersions(options.dev, options.sdkVersion);
+  await copyTemplate(projectPath, validatedTemplate, versions, options.dev);
   updatePackageJson(projectPath, packageName);
   updateIndexTs(projectPath, packageName);
   let install = options.install;
@@ -2168,8 +2134,8 @@ async function main() {
     console.log(
       yellow("\u{1F527} Development mode: Using workspace dependencies")
     );
-  } else if (options.canary) {
-    console.log(cyan("\u{1F680} Canary mode: Using canary versions of packages"));
+  } else if (options.sdkVersion) {
+    console.log(cyan(`\u{1F4CC} Using mcp-use@${options.sdkVersion}`));
   }
   console.log("");
   console.log(bold("\u{1F4C1} Project structure:"));
@@ -2189,7 +2155,7 @@ async function main() {
     console.log("   \u251C\u2500\u2500 resources/");
     console.log("   \u2502   \u2514\u2500\u2500 product-search-result/");
     console.log("   \u2502       \u2514\u2500\u2500 view.tsx");
-    console.log("   \u251C\u2500\u2500 src/register.d.ts");
+    console.log("   \u251C\u2500\u2500 tools.d.ts");
     console.log("   \u251C\u2500\u2500 index.ts (server entry point)");
     console.log("   \u251C\u2500\u2500 package.json");
     console.log("   \u251C\u2500\u2500 tsconfig.json");

package/dist/templates/blank/package.json

@@ -1,6 +1,9 @@
 {
   "name": "mcp-use server",
   "type": "module",
+  "engines": {
+    "node": ">=22.22.2"
+  },
   "version": "1.0.0",
   "description": "Blank mcp-use server",
   "author": "",
@@ -16,13 +19,14 @@
     "build": "mcp-use build",
     "dev": "mcp-use dev",
     "start": "mcp-use start",
-    "deploy": "mcp-use deploy"
+    "deploy": "mcp-use deploy",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "mcp-use": "workspace:*"
   },
   "devDependencies": {
-    "@types/node": "^24.13.2",
-    "typescript": "7.0.1-rc"
+    "@types/node": "^22.20.0",
+    "typescript": "^7.0.2"
   }
 }

package/dist/templates/blank/tsconfig.json

@@ -13,11 +13,7 @@
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "incremental": true,
-    "tsBuildInfoFile": "./dist/.tsbuildinfo",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    }
+    "tsBuildInfoFile": "./dist/.tsbuildinfo"
   },
   "include": ["index.ts", "src/**/*", "resources/**/*", "server.ts", ".mcp-use/**/*.d.ts"],
   "exclude": ["node_modules", "dist"]

package/dist/templates/mcp-apps/index.ts

@@ -15,7 +15,7 @@ const server = new MCPServer({
   description: "An MCP Apps server built with mcp-use",
 });
 
-server.tool(
+export const searchFruits = server.tool(
   {
     name: "search-fruits",
     description: "Search the fruit catalog",

package/dist/templates/mcp-apps/package.json

@@ -1,6 +1,9 @@
 {
   "name": "mcp-use server",
   "type": "module",
+  "engines": {
+    "node": ">=22.22.2"
+  },
   "version": "1.0.0",
   "description": "MCP server with a standard MCP Apps view",
   "author": "",
@@ -26,14 +29,14 @@
   },
   "dependencies": {
     "mcp-use": "workspace:*",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^24.13.2",
+    "@types/node": "^22.20.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "typescript": "7.0.1-rc"
+    "typescript": "^7.0.2"
   }
 }

package/dist/templates/mcp-apps/resources/product-search-result/view.tsx

@@ -3,14 +3,13 @@ import { useToolContext } from "mcp-use/react";
 export default function ProductSearchResult() {
   const view = useToolContext<"search-fruits">();
 
-  if (view.status === "pending" || view.status === "streaming") {
+  if (view.status === "pending") {
     return (
       <p>
         Searching{view.toolInput?.query ? ` for ${view.toolInput.query}` : ""}…
       </p>
     );
   }
-  if (view.status === "cancelled") return <p>Search cancelled.</p>;
   if (view.status === "error") return <p>{view.error.message}</p>;
 
   return (

package/dist/templates/mcp-apps/tools.d.ts

@@ -0,0 +1,8 @@
+// Created by mcp-use when missing. Existing files are never overwritten.
+declare module "mcp-use/react" {
+  interface Register {
+    tools: typeof import("./index.js");
+  }
+}
+
+export {};

package/dist/templates/mcp-apps/tsconfig.json

@@ -13,6 +13,6 @@
     "noUncheckedIndexedAccess": true,
     "exactOptionalPropertyTypes": true
   },
-  "include": ["index.ts", "src/**/*", "resources/**/*"],
+  "include": ["index.ts", "tools.d.ts", "resources/**/*"],
   "exclude": ["node_modules", "dist"]
 }

package/dist/templates/starter/package.json

@@ -1,6 +1,9 @@
 {
   "name": "mcp-use server",
   "type": "module",
+  "engines": {
+    "node": ">=22.22.2"
+  },
   "version": "1.0.0",
   "description": "MCP server with starter tools, resources, and prompts",
   "author": "",
@@ -19,14 +22,15 @@
     "build": "mcp-use build",
     "dev": "mcp-use dev",
     "start": "mcp-use start",
-    "deploy": "mcp-use deploy"
+    "deploy": "mcp-use deploy",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "mcp-use": "workspace:*",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^24.13.2",
-    "typescript": "7.0.1-rc"
+    "@types/node": "^22.20.0",
+    "typescript": "^7.0.2"
   }
 }

package/dist/templates/starter/tsconfig.json

@@ -13,11 +13,7 @@
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "incremental": true,
-    "tsBuildInfoFile": "./dist/.tsbuildinfo",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    }
+    "tsBuildInfoFile": "./dist/.tsbuildinfo"
   },
   "include": ["index.ts", "src/**/*", "resources/**/*", "server.ts", ".mcp-use/**/*.d.ts"],
   "exclude": ["node_modules", "dist"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mcp-use-app",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.2",
   "type": "module",
   "description": "Create MCP-Use apps with one command",
   "author": "mcp-use, Inc.",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.22.2"
   },
   "dependencies": {},
   "devDependencies": {

package/dist/templates/mcp-apps/src/register.d.ts

@@ -1,7 +0,0 @@
-declare module "mcp-use/react" {
-  interface Register {
-    tools: typeof import("../index.js");
-  }
-}
-
-export {};