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

package/dist/prompts.d.ts

@@ -0,0 +1,16 @@
+import * as p from "@clack/prompts";
+export declare function isInteractive(): boolean;
+type PromptTextOptions = {
+    defaultValue?: string;
+    validate?: (value: string) => string | undefined;
+};
+export declare function promptText(message: string, options?: PromptTextOptions): Promise<string>;
+export declare function promptConfirm(message: string, initialValue?: boolean): Promise<boolean>;
+type SelectItem = {
+    label: string;
+    value: string;
+};
+export declare function promptSelect(message: string, items: SelectItem[], defaultIndex?: number): Promise<string>;
+export declare const spinner: ({ indicator, onCancel, output, cancelMessage, errorMessage, frames, delay, signal, ...opts }?: p.SpinnerOptions) => p.SpinnerResult;
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAUD,KAAK,iBAAiB,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAClD,CAAC;AAEF,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,UAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EAAE,EACnB,YAAY,SAAI,GACf,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,eAAO,MAAM,OAAO,sIAAY,CAAC"}

package/dist/templates/blank/index.ts

@@ -1,98 +1,10 @@
-import { MCPServer } from "mcp-use/server";
+import { MCPServer } from "mcp-use";
 
-// Create MCP server instance
 const server = new MCPServer({
   name: "{{PROJECT_NAME}}",
-  title: "{{PROJECT_NAME}}", // display name
+  title: "{{PROJECT_NAME}}",
   version: "1.0.0",
-  description: "Blank mcp-use server",
-  baseUrl: process.env.MCP_URL || "http://localhost:3000", // Full base URL (e.g., https://myserver.com)
-  favicon: "favicon.ico",
-  websiteUrl: "https://mcp-use.com", // Can be customized later
-  icons: [
-    {
-      src: "icon.svg",
-      mimeType: "image/svg+xml",
-      sizes: ["512x512"],
-    },
-  ],
+  description: "A blank MCP server built with mcp-use",
 });
 
-/**
- * Define UI Widgets
- * All React components in the `resources/` folder
- * are automatically registered as MCP tools and resources.
- *
- * Just export widgetMetadata with description and Zod schema,
- * and mcp-use handles the rest!
- *
- * Docs: https://mcp-use.com/docs/typescript/server/mcp-apps
- */
-
-/*
- * Define MCP tools
- * Docs: https://mcp-use.com/docs/typescript/server/tools
- *
- * Response helpers (`text`, `object`, `image`, `markdown`, `html`, `error`,
- * `widget`, ...) are exported from `mcp-use/server`.
-
-import { text } from "mcp-use/server";
-import { z } from "zod";
-
-server.tool(
-  {
-    name: "fetch-weather",
-    description: "Fetch the weather for a city",
-    schema: z.object({
-      city: z.string().describe("The city to fetch the weather for"),
-    }),
-  },
-  async ({ city }) => {
-    const response = await fetch(`https://wttr.in/${city}?format=j1`);
-    const data: any = await response.json();
-    const current = data.current_condition[0];
-    return text(`The weather in ${city} is ${current.weatherDesc[0].value}. Temperature: ${current.temp_C}°C, Humidity: ${current.humidity}%`);
-  }
-);
- */
-
-/*
- * Define MCP resources
- * Docs: https://mcp-use.com/docs/typescript/server/resources
-
-import { object } from "mcp-use/server";
-
-server.resource({
-  name: "config",
-  uri: "config://settings",
-  description: "Server configuration",
-}, async () => object({
-  theme: "dark",
-  language: "en",
-}));
-*/
-
-/*
- * Define MCP prompts
- * Docs: https://mcp-use.com/docs/typescript/server/prompts
-
-import { text } from "mcp-use/server";
-import { z } from "zod";
-
-server.prompt(
-  {
-    name: "review-code",
-    description: "Review code for best practices and potential issues",
-    schema: z.object({
-      code: z.string().describe("The code to review"),
-    }),
-  },
-  async ({ code }) => {
-    return text(`Please review this code:\n\n${code}`);
-  }
-); */
-
-const PORT = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-console.log(`Server running on port ${PORT}`);
-// Start the server
-server.listen(PORT);
+export default server;

package/dist/templates/blank/package.json

@@ -13,25 +13,16 @@
   ],
   "main": "dist/index.js",
   "scripts": {
-    "postinstall": "mcp-use generate-types || exit 0",
     "build": "mcp-use build",
     "dev": "mcp-use dev",
     "start": "mcp-use start",
     "deploy": "mcp-use deploy"
   },
   "dependencies": {
-    "mcp-use": "workspace:*",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-router": "^7.13.0",
-    "tailwindcss": "^4.2.0",
-    "zod": "4.3.5"
+    "mcp-use": "workspace:*"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "@types/node": "^24.13.2",
+    "typescript": "7.0.1-rc"
   }
 }

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

@@ -1,137 +1,43 @@
-import { MCPServer, object, text, widget } from "mcp-use/server";
+import { MCPServer } from "mcp-use";
 import { z } from "zod";
 
+const fruits = ["apple", "banana", "mango", "orange", "strawberry"];
+
+const outputSchema = z.object({
+  query: z.string(),
+  items: z.array(z.object({ id: z.string(), name: z.string() })),
+});
+
 const server = new MCPServer({
   name: "{{PROJECT_NAME}}",
-  title: "{{PROJECT_NAME}}", // display name
+  title: "{{PROJECT_NAME}}",
   version: "1.0.0",
-  description: "MCP server with MCP Apps integration",
-  instructions:
-    "Use search-tools to find fruit matches before calling get-fruit-details. Prefer the widget result when the user wants to browse or compare options visually.",
-  baseUrl: process.env.MCP_URL || "http://localhost:3000", // Full base URL (e.g., https://myserver.com)
-  favicon: "favicon.ico",
-  websiteUrl: "https://mcp-use.com", // Can be customized later
-  icons: [
-    {
-      src: "icon.svg",
-      mimeType: "image/svg+xml",
-      sizes: ["512x512"],
-    },
-  ],
-});
-
-/**
- * TOOL THAT RETURNS A WIDGET
- * The `widget` config tells mcp-use which widget component to render.
- * The `widget()` helper in the handler passes props to that component.
- * Docs: https://mcp-use.com/docs/typescript/server/mcp-apps
- */
-
-// Fruits data — color values are Tailwind bg-[] classes used by the carousel UI
-const fruits = [
-  { fruit: "mango", color: "bg-[#FBF1E1] dark:bg-[#FBF1E1]/10" },
-  { fruit: "pineapple", color: "bg-[#f8f0d9] dark:bg-[#f8f0d9]/10" },
-  { fruit: "cherries", color: "bg-[#E2EDDC] dark:bg-[#E2EDDC]/10" },
-  { fruit: "coconut", color: "bg-[#fbedd3] dark:bg-[#fbedd3]/10" },
-  { fruit: "apricot", color: "bg-[#fee6ca] dark:bg-[#fee6ca]/10" },
-  { fruit: "blueberry", color: "bg-[#e0e6e6] dark:bg-[#e0e6e6]/10" },
-  { fruit: "grapes", color: "bg-[#f4ebe2] dark:bg-[#f4ebe2]/10" },
-  { fruit: "watermelon", color: "bg-[#e6eddb] dark:bg-[#e6eddb]/10" },
-  { fruit: "orange", color: "bg-[#fdebdf] dark:bg-[#fdebdf]/10" },
-  { fruit: "avocado", color: "bg-[#ecefda] dark:bg-[#ecefda]/10" },
-  { fruit: "apple", color: "bg-[#F9E7E4] dark:bg-[#F9E7E4]/10" },
-  { fruit: "pear", color: "bg-[#f1f1cf] dark:bg-[#f1f1cf]/10" },
-  { fruit: "plum", color: "bg-[#ece5ec] dark:bg-[#ece5ec]/10" },
-  { fruit: "banana", color: "bg-[#fdf0dd] dark:bg-[#fdf0dd]/10" },
-  { fruit: "strawberry", color: "bg-[#f7e6df] dark:bg-[#f7e6df]/10" },
-  { fruit: "lemon", color: "bg-[#feeecd] dark:bg-[#feeecd]/10" },
-];
-
-// structuredContent schema for the search-tools result. The widget renders this
-// data (it arrives as the widget's tool output / structuredContent).
-const fruitRowSchema = z.object({
-  fruit: z.string(),
-  color: z.string(),
+  description: "An MCP Apps server built with mcp-use",
 });
 
 server.tool(
   {
-    name: "search-tools",
-    title: "Search fruits",
-    description: "Search for fruits and display the results in a visual widget",
-    schema: z.object({
-      query: z.string().optional().describe("Search query to filter fruits"),
-    }),
-    // Hosts (e.g. ChatGPT) expect explicit hints. Use openWorldHint: true for HTTP/API calls;
-    // destructiveHint: true when deleting or overwriting user data.
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false,
-      openWorldHint: false,
-    },
-    outputSchema: z.object({
-      query: z.string(),
-      results: z.array(fruitRowSchema),
-    }),
-    widget: {
+    name: "search-fruits",
+    description: "Search the fruit catalog",
+    inputSchema: z.object({ query: z.string().optional() }),
+    outputSchema,
+    view: {
       name: "product-search-result",
-      invoking: "Searching...",
-      invoked: "Results loaded",
+      description: "Fruit search results",
+      prefersBorder: true,
     },
+    annotations: { readOnlyHint: true, openWorldHint: false },
   },
-  async ({ query }) => {
-    const results = fruits.filter(
-      (f) => !query || f.fruit.toLowerCase().includes(query.toLowerCase())
-    );
-
-    // let's emulate a delay to show the loading state
-    await new Promise((resolve) => setTimeout(resolve, 2000));
-
-    // `props` become the tool result's structuredContent (delivered to the
-    // widget) and are type-checked against the outputSchema above.
-    return widget({
-      props: { query: query ?? "", results },
-      output: text(
-        `Found ${results.length} fruits matching "${query ?? "all"}"`
-      ),
-    });
+  async ({ query = "" }) => {
+    const items = fruits
+      .filter((fruit) => fruit.includes(query.toLowerCase()))
+      .map((fruit) => ({ id: fruit, name: fruit }));
+    const data = { query, items };
+    return {
+      content: [{ type: "text", text: `Found ${items.length} fruits.` }],
+      structuredContent: data,
+    };
   }
 );
 
-server.tool(
-  {
-    name: "get-fruit-details",
-    title: "Get fruit details",
-    description: "Get detailed information about a specific fruit",
-    schema: z.object({
-      fruit: z.string().describe("The fruit name"),
-    }),
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false,
-      openWorldHint: false,
-    },
-    outputSchema: z.object({
-      fruit: z.string(),
-      color: z.string(),
-      facts: z.array(z.string()),
-    }),
-  },
-  async ({ fruit }) => {
-    const found = fruits.find(
-      (f) => f.fruit?.toLowerCase() === fruit?.toLowerCase()
-    );
-    return object({
-      fruit: found?.fruit ?? fruit,
-      color: found?.color ?? "unknown",
-      facts: [
-        `${fruit} is a delicious fruit`,
-        `Color: ${found?.color ?? "unknown"}`,
-      ],
-    });
-  }
-);
-
-server.listen().then(() => {
-  console.log(`Server running`);
-});
+export default server;

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

@@ -2,7 +2,7 @@
   "name": "mcp-use server",
   "type": "module",
   "version": "1.0.0",
-  "description": "MCP server with OpenAI Apps SDK integration",
+  "description": "MCP server with a standard MCP Apps view",
   "author": "",
   "license": "MIT",
   "keywords": [
@@ -12,12 +12,9 @@
     "tools",
     "resources",
     "prompts",
-    "uiresource",
     "ui",
     "react",
-    "widgets",
-    "mcp-ui",
-    "apps-sdk"
+    "mcp-apps"
   ],
   "main": "dist/index.js",
   "scripts": {
@@ -25,22 +22,18 @@
     "dev": "mcp-use dev",
     "start": "mcp-use start",
     "deploy": "mcp-use deploy",
-    "postinstall": "mcp-use generate-types || exit 0"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@openai/apps-sdk-ui": "^0.2.1",
     "mcp-use": "workspace:*",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "react-router": "^7.13.0",
-    "tailwindcss": "^4.2.0",
-    "zod": "4.3.5"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
+    "@types/node": "^24.13.2",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "7.0.1-rc"
   }
 }

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

@@ -0,0 +1,26 @@
+import { useToolContext } from "mcp-use/react";
+
+export default function ProductSearchResult() {
+  const view = useToolContext<"search-fruits">();
+
+  if (view.status === "pending" || view.status === "streaming") {
+    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 (
+    <main>
+      <h1>Fruit results</h1>
+      <ul>
+        {view.toolOutput.items.map((item) => (
+          <li key={item.id}>{item.name}</li>
+        ))}
+      </ul>
+    </main>
+  );
+}

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

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

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

@@ -1,24 +1,18 @@
 {
   "compilerOptions": {
-    "target": "ES2022",
+    "target": "ES2024",
     "jsx": "react-jsx",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "allowJs": true,
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2024", "DOM", "DOM.Iterable"],
     "strict": true,
-    "outDir": "./dist",
-    "sourceMap": true,
-    "allowSyntheticDefaultImports": true,
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
-    "incremental": true,
-    "tsBuildInfoFile": "./dist/.tsbuildinfo",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    }
+    "noEmit": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true
   },
-  "include": ["index.ts", "src/**/*", "resources/**/*", "server.ts", ".mcp-use/**/*.d.ts"],
+  "include": ["index.ts", "src/**/*", "resources/**/*"],
   "exclude": ["node_modules", "dist"]
 }

package/dist/templates/starter/index.ts

@@ -1,114 +1,77 @@
-import { MCPServer, object, text, completable } from "mcp-use/server";
+import { completable, MCPServer } from "mcp-use";
 import { z } from "zod";
 
-// Create MCP server instance
 const server = new MCPServer({
   name: "{{PROJECT_NAME}}",
-  title: "{{PROJECT_NAME}}", // display name
+  title: "{{PROJECT_NAME}}",
   version: "1.0.0",
-  description: "My first MCP server with all features",
-  instructions:
-    "Use fetch-weather for current conditions, read config://settings before assuming user preferences, and use review-code only when the user asks for code feedback.",
-  baseUrl: process.env.MCP_URL || "http://localhost:3000", // Full base URL (e.g., https://myserver.com)
-  favicon: "favicon.ico",
-  websiteUrl: "https://mcp-use.com", // Can be customized later
-  icons: [
-    {
-      src: "icon.svg",
-      mimeType: "image/svg+xml",
-      sizes: ["512x512"],
-    },
-  ],
+  description: "An MCP server built with mcp-use",
 });
 
-/**
- * Define UI Widgets
- * All React components in the `resources/` folder
- * are automatically registered as MCP tools and resources.
- *
- * Just export widgetMetadata with description and Zod schema,
- * and mcp-use handles the rest!
- *
- * Docs: https://manufact.com/docs/typescript/server/mcp-apps
- */
-
-/*
- * Define MCP tools
- * Docs: https://mcp-use.com/docs/typescript/server/tools
- */
 server.tool(
   {
     name: "fetch-weather",
-    title: "Fetch weather",
-    description: "Fetch the weather for a city",
-    schema: z.object({
-      city: z.string().describe("The city to fetch the weather for"),
-    }),
-    // Declare outputSchema for any tool that returns structuredContent so clients
-    // can validate results and the model can reason about follow-up calls.
+    description: "Return demo weather for a city",
+    inputSchema: z.object({ city: z.string() }),
     outputSchema: z.object({
-      city: z.string().describe("The city the weather is for"),
-      conditions: z.string().describe("Human-readable weather conditions"),
-      temperature: z.string().describe("Current temperature"),
+      city: z.string(),
+      conditions: z.string(),
+      temperature: z.string(),
     }),
-    // Demo stub — no network. If you call an external weather API, set openWorldHint: true.
-    annotations: {
-      readOnlyHint: true,
-      destructiveHint: false,
-      openWorldHint: false,
-    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
   },
-  // The returned object is type-checked against the `outputSchema` above:
-  // returning the wrong shape is a compile-time error.
   async ({ city }) => {
-    return object({ city, conditions: "sunny", temperature: "22°C" });
+    const weather = { city, conditions: "sunny", temperature: "22°C" };
+    return {
+      content: [{ type: "text", text: JSON.stringify(weather) }],
+      structuredContent: weather,
+    };
   }
 );
 
-/*
- * Define MCP resources
- * Docs: https://mcp-use.com/docs/typescript/server/resources
- */
 server.resource(
   {
-    name: "config",
+    name: "settings",
     uri: "config://settings",
-    description: "Server configuration",
+    description: "Example application settings",
+    mimeType: "application/json",
   },
-  async () =>
-    object({
-      theme: "dark",
-      language: "en",
-    })
+  async (uri) => ({
+    contents: [
+      {
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify({ theme: "dark", language: "en" }),
+      },
+    ],
+  })
 );
 
-/*
- * Define MCP prompts
- * Docs: https://mcp-use.com/docs/typescript/server/prompts
- */
 server.prompt(
   {
     name: "review-code",
-    description: "Review code for best practices and potential issues",
+    description: "Review code for correctness and maintainability",
     schema: z.object({
       language: completable(z.string(), [
-        "python",
-        "javascript",
         "typescript",
-        "java",
-        "cpp",
+        "javascript",
+        "python",
         "go",
-        "rust",
-      ]).describe("The programming language"),
-      code: z.string().describe("The code to review"),
+      ]),
+      code: z.string(),
     }),
   },
-  async ({ language, code }) => {
-    return text(`Reviewing ${language} code:\n\n${code}`);
-  }
+  async ({ language, code }) => ({
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: `Review this ${language} code:\n\n${code}`,
+        },
+      },
+    ],
+  })
 );
 
-const PORT = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-console.log(`Server running on port ${PORT}`);
-// Start the server
-server.listen(PORT);
+export default server;

package/dist/templates/starter/package.json

@@ -2,7 +2,7 @@
   "name": "mcp-use server",
   "type": "module",
   "version": "1.0.0",
-  "description": "MCP server with starter tools and resources",
+  "description": "MCP server with starter tools, resources, and prompts",
   "author": "",
   "license": "MIT",
   "keywords": [
@@ -12,16 +12,10 @@
     "tools",
     "resources",
     "prompts",
-    "uiresource",
-    "ui",
-    "react",
-    "widgets",
-    "mcp-ui",
-    "apps-sdk"
+    "mcp-use"
   ],
   "main": "dist/index.js",
   "scripts": {
-    "postinstall": "mcp-use generate-types || exit 0",
     "build": "mcp-use build",
     "dev": "mcp-use dev",
     "start": "mcp-use start",
@@ -29,17 +23,10 @@
   },
   "dependencies": {
     "mcp-use": "workspace:*",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-router": "^7.13.0",
-    "tailwindcss": "^4.2.0",
-    "zod": "4.3.5"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "@types/node": "^24.13.2",
+    "typescript": "7.0.1-rc"
   }
 }