Easy-Vibe is an AI-assisted app builder that lets you turn ideas into interactive AI-powered applications using natural language. With this MCP server, you can access an AI IDE workflow that guides you from idea capture to prototype generation, integrating AI capabilities such as text, image, and code generation, all through conversational prompts or guided tutorials. The platform exposes learning paths, project templates, and interactive tutorials that help you specify features, design UI flows, and connect AI capabilities to your app ideas. You can use it to quickly validate product concepts, assemble minimal viable prototypes, and iterate with AI-driven enhancements. The MCP server exposes utilities to load stage-based lessons, fetch sample templates, and generate multi-page prototypes based on your spoken or typed requirements.

To use it, start the Easy-Vibe MCP server and connect to its API endpoints or CLI tooling provided by the server package. Follow the guided prompts to describe what you want (e.g., a to-do app with chat-based assistant, an AI-driven blog with comments, or a booking system with login). The system will translate your description into a runnable prototype, generate UI screens, wire up AI capabilities (like natural language processing, image generation, or code scaffolding), and deliver a demonstrable prototype you can run locally or deploy. For advanced usage, explore the learning maps and interactive tutorials to learn how to leverage AI IDE tooling, RAG data flows, and cross-platform deployment patterns supported by Easy-Vibe.

Prerequisites:

• Node.js (version 14+ recommended) and npm installed
• Git (optional, for cloning the repository)
• Access to an OpenAI-compatible API key (for AI capabilities)

1. Clone the repository (or download the MCP server package): git clone https://github.com/datawhalechina/easy-vibe.git cd easy-vibe

2. Install dependencies: npm install

3)Configure environment variables (examples): Create a .env file with the following entries: OPENAI_API_KEY=your-openai-api-key PORT=3000 NODE_ENV=development

4. Run the MCP server: npm run start

   or if a direct node script is used:

   node server.js

5. Verify the server is running by visiting http://localhost:3000 or the configured port. If you are deploying behind a reverse proxy, adjust the port or proxy settings accordingly.

6. Optional: build and run in Docker (if a Dockerfile is provided): docker build -t easy-vibe:latest . docker run -p 3000:3000 easy-vibe:latest

Notes:

• Ensure your OpenAI API key is valid and has sufficient quota for your usage.
• If your deployment requires additional services (e.g., a database or authentication), configure those connections as described in the repository's docs.
• Check for any project-specific setup steps in the repository's docs or tutorials, as the author may have additional configuration options.

Tips and common issues:

• Environment variables: Always set OPENAI_API_KEY and PORT. Some deployments also require a NANODECK or DB connection string depending on features used.
• If you encounter connectivity issues to the AI service, verify your network firewall and API key permissions.
• For best results, start with the basic learning map and stage tutorials to understand how Easy-Vibe wires AI capabilities into app prototypes.
• When deploying to production, consider setting NODE_ENV=production, enabling TLS, and configuring a reverse proxy (e.g., Nginx) in front of the MCP server.
• If the server fails to start due to port conflicts, change PORT in the environment or command line.
• Review logs for warnings about missing templates or data sources and consult the docs for supported templates and data integrations.