@back4app/mcp-installer

CLI tool to install and configure Back4App MCP server across different AI IDEs with a single command.

Features

• 🚀 One-command installation - Install Back4App MCP server in any supported IDE
• 🔧 Multi-IDE support - Works with Cursor, Windsurf, Cline, Claude, VS Code, and more
• ✅ Smart configuration - Automatically manages MCP configuration files
• 📊 Status checking - Check installation status across all IDEs
• 🗑️ Easy removal - Uninstall with a single command
• 🌍 Global installation - All IDEs use global configuration

Supported IDEs

• Cursor (~/.cursor/mcp.json)
• Windsurf (~/.codeium/windsurf/mcp_config.json)
• Cline (~/.cline/mcp_config.json)
• Claude Desktop (~/.claude/mcp_config.json)
• VS Code (~/.vscode/mcp.json)
• Witsy (~/.witsy/mcp_config.json)
• Enconvo (~/.enconvo/mcp_config.json)

Note: All IDEs use global configuration files in your home directory for consistent access across all projects.

Quick Start

# Install globally via npm
npm install -g @back4app/mcp-installer

# Install for specific IDE
mcp-installer install cursor --account-key YOUR_ACCOUNT_KEY
mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY   # Creates ~/.vscode/mcp.json

Installation Methods

Method 1: Global Installation

npm install -g @back4app/mcp-installer
mcp-installer install <ide> --account-key YOUR_ACCOUNT_KEY

Method 2: One-time Usage (npx)

npx @back4app/mcp-installer install <ide> --account-key YOUR_ACCOUNT_KEY

Method 3: One-time Usage

npx @back4app/mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY
# This creates ~/.vscode/mcp.json in your home directory

Commands

Install Back4App MCP Server

mcp-installer install <ide> --account-key <your-account-key>

Examples:

# Install for Cursor (global config)
mcp-installer install cursor --account-key sk-1234567890abcdef

# Install for VS Code (global config)
mcp-installer install vscode --account-key sk-1234567890abcdef

Check Installation Status

# Check specific IDE
mcp-installer status cursor

# Check all IDEs
mcp-installer status

List Supported IDEs

mcp-installer list

Uninstall Back4App MCP Server

mcp-installer uninstall <ide>

Configuration Details

All IDEs use global configuration for consistent access across projects:

• Global installation - Creates configuration files in your home directory (~/.ide/)
• Cross-project - Configuration works across all your projects
• Persistent - Settings persist across IDE restarts and project switches

Workflow for all IDEs:

# Install MCP configuration globally
mcp-installer install vscode --account-key YOUR_ACCOUNT_KEY

# The configuration is now in ~/.vscode/mcp.json
# 4. Restart VS Code to load the new MCP server
# 5. Access Back4App tools in VS Code's AI panel

Getting Your Account Key

1. Sign up at Back4App
2. Go to your account settings
3. Generate or copy your MCP account key
4. Use it with the --account-key parameter

What Gets Installed

The installer adds this configuration to your IDE's MCP settings:

{
  "mcpServers": {
    "back4app": {
      "command": "npx",
      "args": [
        "-y",
        "@back4app/mcp-server-back4app@latest",
        "--account-key",
        "YOUR_ACCOUNT_KEY"
      ]
    }
  }
}

Troubleshooting

VS Code Issues

• Restart VS Code after installation
• Check that ~/.vscode/mcp.json exists in your home directory
• Verify your account key is correct

General Issues

• Ensure you have Node.js and npm installed
• Verify your Back4App account key is valid
• Try uninstalling and reinstalling if configuration seems corrupted
• Check that your IDE supports MCP (recent versions required)

Development

# Clone and setup
git clone <repository-url>
cd mcp-installer
npm install

# Build  
npm run build

# Test locally
node dist/index.js --help

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Related Projects

• Back4App MCP Server - The actual MCP server this tool installs
• Back4App - Backend-as-a-Service platform

Support

• 📖 Documentation
• 🐛 Issues
• 💬 Community

Made with ❤️ by the Back4App team