Skip to main content

​
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>

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