@back4app/mcp-installer

@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

• Sign up at Back4App
• Go to your account settings
• Generate or copy your MCP account key
• 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