Project Management

Complete guide to managing your MCP projects using the LeanMCP CLI.

Create Project

Create a new MCP server project locally:

leanmcp create <project-name>

With Auto-Install (Recommended)

leanmcp create my-mcp-server --install

Example Output:

Creating project my-mcp-server...

Project created successfully!

  cd my-mcp-server
  npm run dev

Your MCP server is ready at http://localhost:3001

Interactive Mode

leanmcp create my-mcp-server

The CLI will prompt you for:

Install dependencies? (y/N)
Start development server? (y/N)

Skip All Prompts

leanmcp create my-mcp-server --allow-all

Development Server

Start the development server with hot reload:

cd my-mcp-server
leanmcp dev

Example Output:

Starting development server...

my-mcp-server MCP Server
Server running at http://localhost:3001
Dashboard: http://localhost:3001/
MCP Endpoint: http://localhost:3001/mcp

List Projects

View all your cloud projects:

leanmcp projects list

Example Output:

Fetching projects...

Your Projects (3)

────────────────────────────────────────────────────────────
  my-mcp-server
    ID: bc1d06ef-d652-4ae6-8977-614c8677606a
    Status: active
    Created: 12/18/2025

  email-assistant
    ID: 4aac8add-acc5-4937-a080-244e77b0e870
    Status: active
    Created: 12/18/2025

  database-helper
    ID: bf0f5a80-3c98-4bcb-aaa7-df48fa4069d8
    Status: active
    Created: 12/18/2025

Get Project Details

Get detailed information about a specific project:

leanmcp projects get <project-id>

Example:

leanmcp projects get bc1d06ef-d652-4ae6-8977-614c8677606a

Example Output:

Fetching project...

Project Details

────────────────────────────────────────────────────────────
  Name: my-mcp-server
  ID: bc1d06ef-d652-4ae6-8977-614c8677606a
  Status: active
  Created: 12/18/2025, 4:39:59 PM
  Updated: 12/18/2025, 4:39:59 PM

Deploy Project

Deploy your MCP server to LeanMCP cloud:

cd my-mcp-server
leanmcp deploy .

Example Output:

Deploying to LeanMCP cloud...

Scanning project files...
Found 12 files to upload

Uploading project...
Upload complete!

Building project...
Build started: build_abc123

Deployment successful!
URL: https://my-mcp-server.leanmcp.com

Delete Project

Remove a project from the cloud:

leanmcp projects delete <project-id>

Example:

leanmcp projects delete bc1d06ef-d652-4ae6-8977-614c8677606a

Example Output:

Deleting project bc1d06ef-d652-4ae6-8977-614c8677606a...

Project deleted successfully!

Full Workflow Example

Complete workflow from creation to deployment:

# 1. Create a new project with dependencies
leanmcp create my-awesome-mcp --install

# 2. Navigate to project
cd my-awesome-mcp

# 3. Start development server (test locally)
leanmcp dev

# 4. When ready, deploy to cloud
leanmcp deploy .

# 5. List your projects to see deployment
leanmcp projects list

# 6. Get details of deployed project
leanmcp projects get <project-id>

File Scanning Rules

When deploying projects, the CLI: Includes:

All source code files (.ts, .js, .py, etc.)
Configuration files (package.json, tsconfig.json, etc.)
Documentation files (README.md, etc.)

Excludes (.gitignore respected):

node_modules/
.git/
dist/, build/
*.log
OS files (.DS_Store, Thumbs.db)
IDE files (.vscode/, .idea/)

Troubleshooting

Not Authenticated

Not authenticated
Run 'leanmcp login' to authenticate.

Solution: Run leanmcp login and enter your API key.

Project Not Found

Project not found

Solution: Verify the project ID using leanmcp projects list.

Deployment Failed

Deployment failed: Build error

Solutions:

Check build logs in the dashboard
Verify project configuration
Ensure all dependencies are in package.json

Next Steps

Deploy to LeanMCP

Deploy your MCP servers to the cloud

Monitor Deployments

View deployment status and logs

Welcome

CLI

Deployment

Best Practices

Platform Features

Security

Comparisons

Examples

Project Management

Project Management

Create Project

With Auto-Install (Recommended)

Interactive Mode

Skip All Prompts

Development Server

List Projects

Get Project Details

Deploy Project

Delete Project

Full Workflow Example

File Scanning Rules

Troubleshooting

Not Authenticated

Project Not Found

Deployment Failed

Next Steps

Deploy to LeanMCP

Monitor Deployments

​Project Management

​Create Project

​With Auto-Install (Recommended)

​Interactive Mode

​Skip All Prompts

​Development Server

​List Projects

​Get Project Details

​Deploy Project

​Delete Project

​Full Workflow Example

​File Scanning Rules

​Troubleshooting

​Not Authenticated

​Project Not Found

​Deployment Failed

​Next Steps

Deploy to LeanMCP

Monitor Deployments

Project Management

Create Project

With Auto-Install (Recommended)

Interactive Mode

Skip All Prompts

Development Server

List Projects

Get Project Details

Deploy Project

Delete Project

Full Workflow Example

File Scanning Rules

Troubleshooting

Not Authenticated

Project Not Found

Deployment Failed

Next Steps