mcp

# @myvtp/mcp

MCP (Model Context Protocol) server for VTP - deploy apps via Claude Code.

## Quick Start

Run the installer to automatically configure your AI coding assistant:

```bash
npx @myvtp/mcp install
```

This will detect and configure any of the following clients:
- **Claude Desktop** - Anthropic's desktop app
- **Claude Code** - Anthropic's CLI tool
- **Cursor** - AI-powered code editor
- **VS Code** - Project-level MCP config
- **Windsurf** - Codeium's AI code editor
- **Project (.mcp.json)** - Generic project-level config

### Installer Options

```bash
npx @myvtp/mcp install              # Interactive mode
npx @myvtp/mcp install --yes        # Configure all detected clients
npx @myvtp/mcp install --yes cursor-desktop  # Configure specific client
npx @myvtp/mcp install --force      # Overwrite existing VTP config
```

Press **Escape** or **Ctrl+C** to cancel the installer.

## Manual Installation

Add to your MCP configuration file:

```json
{
  "mcpServers": {
    "vtp": {
      "command": "npx",
      "args": ["-y", "@myvtp/mcp"]
    }
  }
}
```

### Config File Locations

| Client | Config Path |
|--------|-------------|
| Claude Desktop (macOS) | `~/Library/Application Support/Cursor/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Cursor\claude_desktop_config.json` |
| Claude Code | `~/.cursor.json` |
| Cursor | `~/.cursor/mcp.json` |
| VS Code | `.vscode/mcp.json` (project-level) |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
| Generic | `.mcp.json` (project-level) |

## Usage

Once configured, simply ask Cursor to deploy your app:

```
Deploy this app to VTP
```

Cursor will analyse your project, create the necessary configuration, and deploy it.

### Available Tools

| Tool | Description |
|------|-------------|
| `deploy` | Deploy an app from a vtp.yaml config |
| `list` | List all deployed apps |
| `list_app_types` | Show supported app types |
| `get_deployment_guide` | Get detailed deployment instructions |

## Co