pmkhairnarr/website-builder-mcp

Website Builder MCP Server

A Model Context Protocol (MCP) server for automated website generation with Excel data integration.

🚀 Features

• ✅ Multiple Website Templates - Portfolio, blog, catalog, directory
• ✅ Excel Data Integration - Build websites directly from Excel files
• ✅ Component Generation - Navbar, hero, cards, forms with multiple styles
• ✅ Responsive Design - Modern CSS framework with mobile support
• ✅ MCP Protocol - Full Model Context Protocol server implementation
• ✅ Automated Pages - Generate individual pages from Excel rows

📊 Excel Integration

Transform Excel spreadsheets into complete websites:

Product Catalog 📦

• Excel Format: Product Name, Description, Price, Category, Image
• Generates: Product grid, individual product pages, category filtering
• Perfect for: E-commerce sites, inventory displays

Staff Directory 👥

• Excel Format: Name, Title, Department, Email, Phone, Bio
• Generates: Team overview, individual profiles, department pages
• Perfect for: Company websites, organization directories

Portfolio Sites 💼

• Excel Format: Project Name, Description, Technologies, Link, Status
• Generates: Project showcase, technology filtering, project details
• Perfect for: Developer portfolios, agency showcases

Custom Data Sites 📋

• Excel Format: Any structured data
• Generates: Data tables, searchable listings, custom layouts
• Perfect for: Reports, listings, catalogs

🛠️ Installation

# Clone the repository
git clone https://github.com/pmkhairnarr/website-builder-mcp.git
cd website-builder-mcp

# Install dependencies
npm install

# Start the MCP server
npm start

📝 Usage

Basic Website Creation

// Create website from template
{
  "name": "create_website",
  "arguments": {
    "name": "my-portfolio",
    "template": "portfolio", 
    "title": "My Portfolio",
    "description": "Showcasing my work"
  }
}

Excel-Powered Websites

// Build from Excel file
{
  "name": "build_from_excel",
  "arguments": {
    "excelFile": "./examples/sample-products.xlsx",
    "template": "catalog",
    "siteName": "product-catalog",
    "sheetName": "Products"
  }
}

📂 Project Structure

website-builder-mcp/
├── server.js              # Main MCP server
├── package.json           # Dependencies & scripts  
├── templates/             # HTML/CSS templates
│   ├── base.html         # Base page template
│   └── styles.css        # Responsive CSS framework
├── examples/              # Sample Excel files
│   ├── sample-products.xlsx
│   ├── sample-directory.xlsx
│   └── sample-portfolio.xlsx
├── websites/              # Generated websites
└── tests/                 # Test files

🔧 Available Tools

Core Tools

• create_website - Create from templates
• add_page - Add pages to existing sites
• generate_component - Create HTML components
• list_websites - List all created sites

Excel Tools

• build_from_excel - Generate complete sites from Excel data

📋 Excel File Format

Product Catalog Example

Staff Directory Example

Portfolio Example

🧪 Testing

# Test Excel integration
npm run test:excel

# Test MCP server
npm test

# Run direct functionality test  
node direct-test.js

🌐 Generated Websites

Websites are created in the websites/ directory with:

• Responsive HTML pages
• Modern CSS styling
• Site configuration (site.json)
• Navigation between pages
• Mobile-friendly design

🔗 MCP Integration

Use with MCP-compatible clients:

• VS Code with MCP extension
• Claude Desktop
• Custom MCP clients

📖 API Documentation

MCP Server Configuration

{
  "mcpServers": {
    "website-builder": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "./website-builder-mcp"
    }
  }
}

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🎯 Use Cases

• Business Websites - Generate company sites from employee data
• Product Showcases - Create catalogs from inventory spreadsheets
• Portfolio Sites - Build project showcases from work data
• Directory Sites - Create searchable listings from contact data
• Report Sites - Transform data reports into web presentations

🚀 Advanced Features

• Automatic slug generation for SEO-friendly URLs
• Responsive grid layouts for all device sizes
• Smart column detection for Excel processing
• Template customization for brand consistency
• Batch processing for large datasets
• Error handling with detailed feedback

Built with ❤️ for the AI Development Community