scaffold-mcp

Model Context Protocol (MCP) server for project scaffolding. Provides tools to list available modules, get installation instructions, and manage scaffold configurations.

Installation

npm install -g scaffold-mcp

Usage with Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "scaffold": {
      "command": "npx",
      "args": [
        "-y",
        "scaffold-mcp",
        "--servers=https://raw.githubusercontent.com/timoconnellaus/scaffold-mcp/main/packages/tanstack-start"
      ]
    }
  }
}

Usage with other MCP clients

# Start with scaffold servers
scaffold-mcp --servers=https://raw.githubusercontent.com/timoconnellaus/scaffold-mcp/main/packages/tanstack-start

# Start with multiple servers
scaffold-mcp --servers=https://raw.githubusercontent.com/timoconnellaus/scaffold-mcp/main/packages/tanstack-start,https://example.com/server2

The server will:

1. Look for scaffold.json in the current directory
2. Create a default scaffold.json if it doesn't exist
3. Make available the specified servers for querying

Available Tools

list_available_modules

List all available modules from configured scaffold servers.

Returns:

• List of available modules with descriptions, versions, and features
• Installation status for each module
• Server information

get_install_instructions

Get step-by-step installation instructions for a specific module.

Parameters:

• moduleName: Name of the module (e.g., "core", "tailwind")
• features: Optional feature configuration object

Returns:

• Prerequisites and dependencies
• Exact installation commands
• Configuration steps
• Compatibility warnings

get_install_plan

Create an installation plan for multiple modules with proper dependency ordering.

Parameters:

• moduleNames: Array of module names to install

Returns:

• Step-by-step installation plan
• Dependency resolution order
• Conflict detection

mark_module_installed

Mark a module as installed in the scaffold.json configuration.

Parameters:

• moduleName: Name of the installed module
• features: Optional feature configuration

Updates:

• Local scaffold.json file
• Module version and feature tracking

Example Usage

Once configured with Claude Desktop, you can ask:

• "What modules are available for scaffolding?"
• "How do I install Tailwind CSS?"
• "Create an installation plan for core, tailwind, and shadcn modules"
• "Show me the steps to add TanStack Query to my project"

Example scaffold.json

The MCP server creates and manages a scaffold.json file in your project:

{
  "modules": {
    "core": {
      "version": "1.0.0",
      "server": "https://raw.githubusercontent.com/timoconnellaus/scaffold-mcp/main/packages/tanstack-start",
      "features": {}
    },
    "tailwind": {
      "version": "1.0.0",
      "server": "https://raw.githubusercontent.com/timoconnellaus/scaffold-mcp/main/packages/tanstack-start",
      "features": {}
    }
  }
}

Available Modules

Currently supports TanStack Start scaffolding with modules:

• core - Base TanStack Start application
• router-devtools - TanStack Router development tools
• tanstack-query - TanStack Query for data fetching
• query-devtools - TanStack Query development tools
• tailwind - Tailwind CSS styling
• shadcn - shadcn/ui component library
• cloudflare - Cloudflare deployment support

License

MIT