Quickstart

This walkthrough takes you from an empty directory to a running multi-app MCP server inside an Nx monorepo.

Create the workspace

npx frontmcp create my-platform --nx
cd my-platform

This scaffolds the full monorepo structure with a sample app.

Generate an app

nx g @frontmcp/nx:app crm

Creates apps/crm/ with a main entry point, app class, and sample tool.

Add a tool

nx g @frontmcp/nx:tool fetch-contacts --project crm

Creates apps/crm/src/tools/fetch-contacts.tool.ts — edit the execute() method to add your logic.

Generate a shared library

nx g @frontmcp/nx:lib shared-utils

Creates libs/shared-utils/ — use it for code shared across apps.

Generate a server

nx g @frontmcp/nx:server production --apps crm --deploymentTarget node

Creates servers/production/ with a Dockerfile, docker-compose.yml, and an entry point that composes the CRM app.

Start development

nx dev crm

Starts the CRM app in development mode with hot-reload.

Build for production

nx build production

Compiles the production server to servers/production/dist/.

Run tests

nx test crm

Runs E2E tests for the CRM app using @frontmcp/testing.

Your monorepo is ready! Add more apps, tools, and libraries as your platform grows.

Project Structure

After completing the steps above, your workspace looks like this:

my-platform/
├── apps/
│   └── crm/
│       ├── src/
│       │   ├── main.ts
│       │   ├── crm.app.ts
│       │   └── tools/
│       │       ├── hello.tool.ts
│       │       └── fetch-contacts.tool.ts
│       ├── project.json
│       └── tsconfig.json
├── libs/
│   └── shared-utils/
│       ├── src/
│       │   ├── shared-utils.ts
│       │   └── index.ts
│       └── project.json
├── servers/
│   └── production/
│       ├── src/main.ts
│       ├── Dockerfile
│       ├── docker-compose.yml
│       └── project.json
├── nx.json
├── tsconfig.base.json
└── package.json

Common Commands

Command	Description
`nx dev <app>`	Start an app with hot-reload
`nx build <project>`	Build an app or server
`nx test <project>`	Run tests
`nx inspector <app>`	Launch MCP Inspector
`nx graph`	Visualize dependency graph
`nx affected -t test`	Test only affected projects
`nx run-many -t build`	Build all projects

Getting Started

Generators

Executors

Guides

Project Structure

Common Commands

Next Steps

Generators

Monorepo Patterns

​Project Structure

​Common Commands

​Next Steps

Generators

Monorepo Patterns

Project Structure

Common Commands

Next Steps