install_next_project

Instructions

Implementation Reference

• src/index.ts:389-433 (handler)

  The handler function for the 'install_next_project' tool. It creates a new Next.js project using 'npx create-next-app' with options for TypeScript, Tailwind, App Router, no Git init, optional dependency installation skip, ensures directory, resolves paths, executes the command, and opens the project in VSCode.

  case "install_next_project": {
    const { 
      projectName, 
      destination, 
      typescript = true,
      installDependencies = true 
    } = args as {
      projectName: string;
      destination: string;
      typescript?: boolean;
      installDependencies?: boolean;
    };
    
    const destPath = resolvePath(destination);
    await ensureDirectory(destPath);
    
    const tsFlag = typescript ? "--typescript" : "--javascript";
    const skipInstallFlag = installDependencies ? "" : "--skip-install";
    const command = `npx create-next-app@latest ${projectName} ${tsFlag} --tailwind --app --no-git ${skipInstallFlag}`;
    
    const { stdout, stderr } = await execa(command, {
      shell: true,
      cwd: destPath,
    });
    
    const projectPath = path.join(destPath, projectName);
    
    // Open in VSCode
    await openInVSCode(projectPath);
    
    return {
      content: [
        {
          type: "text",
          text: `Next.js project "${projectName}" created successfully at ${projectPath}\n\n` +
                `TypeScript: ${typescript ? "Yes" : "No"}\n` +
                `Dependencies: ${installDependencies ? "Installed" : "Not installed (run npm install manually)"}\n` +
                `VSCode: Opened\n\n` +
                `To start development:\n` +
                `  cd ${projectPath}\n` +
                `  ${installDependencies ? "" : "npm install\n  "}npm run dev`,
        },
      ],
    };
  }

• src/index.ts:172-196 (registration)

  Registration of the 'install_next_project' tool in the list of available tools, including its name, description, and input schema definition.

    name: "install_next_project",
    description: "Create a new Next.js project and open it in VSCode",
    inputSchema: {
      type: "object",
      properties: {
        projectName: {
          type: "string",
          description: "Name of the Next.js project",
        },
        destination: {
          type: "string",
          description: "Directory where to create the project (e.g., ~/Desktop)",
        },
        typescript: {
          type: "boolean",
          description: "Use TypeScript (default: true)",
        },
        installDependencies: {
          type: "boolean",
          description: "Install dependencies after creating project (default: true)",
        },
      },
      required: ["projectName", "destination"],
    },
  },

• src/index.ts:172-196 (schema)

  Input schema for the 'install_next_project' tool, defining parameters like projectName (required), destination (required), typescript (boolean, default true), installDependencies (boolean, default true).

    name: "install_next_project",
    description: "Create a new Next.js project and open it in VSCode",
    inputSchema: {
      type: "object",
      properties: {
        projectName: {
          type: "string",
          description: "Name of the Next.js project",
        },
        destination: {
          type: "string",
          description: "Directory where to create the project (e.g., ~/Desktop)",
        },
        typescript: {
          type: "boolean",
          description: "Use TypeScript (default: true)",
        },
        installDependencies: {
          type: "boolean",
          description: "Install dependencies after creating project (default: true)",
        },
      },
      required: ["projectName", "destination"],
    },
  },

• src/index.ts:34-57 (helper)

  Helper function to open a project directory in VSCode, trying multiple possible 'code' command paths if the default fails.

  async function openInVSCode(projectPath: string): Promise<void> {
    try {
      await execa("code", [projectPath]);
    } catch (error) {
      // If 'code' command fails, try common VSCode executable paths
      const vscodePaths = [
        "code",
        "/usr/local/bin/code",
        "/usr/bin/code",
        "C:\\Program Files\\Microsoft VS Code\\Code.exe",
        "C:\\Program Files (x86)\\Microsoft VS Code\\Code.exe",
      ];
  
      for (const codePath of vscodePaths) {
        try {
          await execa(codePath, [projectPath]);
          return;
        } catch {
          // Continue to next path
        }
      }
      
      throw new Error("VSCode not found. Please ensure VSCode is installed and 'code' command is available in PATH");
    }

• src/index.ts:17-22 (helper)

  Helper function to ensure a directory exists, creating it recursively if necessary.

  async function ensureDirectory(dirPath: string): Promise<void> {
    try {
      await fs.mkdir(dirPath, { recursive: true });
    } catch (error) {
      console.error(`Error creating directory ${dirPath}:`, error);
    }