@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:

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

npx @myvtp/mcp install              # Interactive mode
npx @myvtp/mcp install --yes        # Configure all detected clients
npx @myvtp/mcp install --yes claude-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:

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

Config File Locations

Client	Config Path
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Claude Code	~/.claude.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 Claude to deploy your app:

Deploy this app to VTP

Claude 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

Configuration

The MCP server connects to the VTP API. By default it uses https://api.myvtp.app.

To use a different API URL (e.g., for local development):

{
  "mcpServers": {
    "vtp": {
      "command": "npx",
      "args": ["-y", "@myvtp/mcp"],
      "env": {
        "VTP_API_URL": "https://api.myvtp.dev"
      }
    }
  }
}

Authentication

On first use, the MCP server will open your browser for authentication. Your credentials are stored locally at ~/.vtp/credentials.json.

License

MIT