Provides a deployment target for the MCP server, allowing it to be hosted on Cloudflare's serverless platform with one-command deployment.
Used as part of the server runtime environment for executing MCP tools and workflows.
Serves as a requirement for the development environment, needed for running the build tools and scripts.
Enables building a modern web interface for the MCP server, providing a frontend for interacting with the server's tools and workflows.
Offers pre-configured UI components to accelerate frontend development for the MCP server interface.
Used for styling the frontend interface of the MCP server, allowing for rapid UI development with utility classes.
Provides type safety across the full stack, with auto-generated RPC client types for communication between frontend and server.
Powers the frontend build system with hot reload capabilities for rapid development.
React + Tailwind MCP Server Template
A full-stack template for building Model Context Protocol (MCP) servers with a modern React frontend. This template provides a complete development environment where your MCP server not only exposes tools and workflows to AI agents but also serves a beautiful web interface built with React and Tailwind CSS.
⨠Features
š¤ MCP Server: Cloudflare Workers-based server with typed tools and workflows
āļø React Frontend: Modern React app with Vite, TanStack Router, and Tailwind CSS
šØ UI Components: Pre-configured shadcn/ui components for rapid development
š§ Type Safety: Full TypeScript support with auto-generated RPC client types
š Hot Reload: Live development with automatic rebuilding for both frontend and backend
āļø Ready to Deploy: One-command deployment to Cloudflare Workers
Related MCP server: AgentMode
š Quick Start
Prerequisites
Node.js ā„18.0.0
Deno ā„2.0.0
Deco CLI:
deno install -Ar -g -n deco jsr:@deco/cli
Setup
The server will start on http://localhost:8787 serving both your MCP endpoints
and the React frontend.
š Project Structure
š ļø Development Workflow
npm run dev- Start development with hot reloadnpm run gen- Generate types for external integrationsnpm run gen:self- Generate types for your own tools/workflowsnpm run deploy- Deploy to production
š Frontend ā Server Communication
The template includes a fully-typed RPC client that connects your React frontend to your MCP server:
š Learn More
This template is built for deploying primarily on top of the Deco platform which can be found at the deco-cx/chat repository.
Ready to build your next MCP server with a beautiful frontend?