create-advanced

This MCP server generator creates a fully structured MCP server project based on the MCP Advanced Node specification. The generated project can include a web API (Express), a WebSocket server, and Prisma ORM integration, all wired into a TypeScript codebase with a clear project layout for tools, resources, prompts, services, and more. To use it, first scaffold a new server project, then install dependencies and run the server. The tooling also provides example implementations for common MCP components, making it easier to extend with your own tools, resources, and prompts.

After scaffolding, navigate to your new project directory and install dependencies. If you opted into web API and WebSocket features, you’ll have corresponding directories and modules ready to customize. Use the available npm scripts or your preferred TS build/run workflow to start the server, then access the web API endpoints or WebSocket events as defined by your configuration. The configuration system supports environment variables for flexibility in different environments.

Prerequisites:

• Node.js (14.x+ or newer) and npm installed on your machine
• A terminal or command prompt

Install the generator globally and scaffold a new MCP server:

# Install the scaffolding tool globally
npm install -g create-advanced-mcp-server

# Create a new MCP server project (replace my-mcp-server with your project name)
npx create-advanced-mcp-server my-mcp-server

Optionally, you can use --yes to accept defaults and skip interactive prompts, or --verbose for detailed output:

npx create-advanced-mcp-server my-mcp-server --yes
npx create-advanced-mcp-server my-mcp-server --verbose

After scaffolding, install dependencies inside the new project directory and start the server according to your environment:

cd my-mcp-server
npm install
# Build if needed (depends on your setup, e.g., npm run build)
npm start

If you’ve chosen optional features (Web API, WebSocket, Prisma), ensure you have any required system dependencies for those features (e.g., a running database for Prisma, or environment variables for API keys).

Tips and common considerations:

• The generated project supports environment variable configuration; consult the config.ts/module in the scaffold to learn which VARs exist and how to customize them for your environment.
• Prisma integration is optional. If enabled, you’ll typically need a database connection string in your environment (e.g., DATABASE_URL) and run migrations as part of setup.
• Web API (Express) and WebSocket components are modular and can be enabled or disabled during generation; you can later customize routes, controllers, and event handlers to fit your MCP needs.
• When upgrading Node.js or dependencies, review the TypeScript target/module settings to ensure compatibility with your runtime (ESM vs CommonJS).
• Ensure proper logging and error handling are wired in, especially for production deployments.
• If you encounter issues with scaffolding, running with --verbose can help diagnose prompts, file generation, and dependency installation problems.