> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leanmcp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Management

> Manage MCP projects with the CLI

# Project Management

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

## Create Project

Create a new MCP server project locally:

```bash theme={null}
leanmcp create <project-name>
```

### With Auto-Install (Recommended)

```bash theme={null}
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

```bash theme={null}
leanmcp create my-mcp-server
```

The CLI will prompt you for:

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

### Skip All Prompts

```bash theme={null}
leanmcp create my-mcp-server --allow-all
```

## Development Server

Start the development server with hot reload:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
leanmcp projects get <project-id>
```

**Example:**

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
leanmcp projects delete <project-id>
```

**Example:**

```bash theme={null}
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:

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="Deploy to LeanMCP" icon="rocket" href="/deploy/leanmcp-platform">
    Deploy your MCP servers to the cloud
  </Card>

  <Card title="Monitor Deployments" icon="chart-line" href="https://leanmcp.com/my-deployments">
    View deployment status and logs
  </Card>
</CardGroup>