Smithery Batch Installer

A bash script tool for batch - installing the Smithery MCP server, supporting two versions: full command input and simplified package name input, which can automatically synchronize installations among multiple clients.

Developer tools Artificial intelligence chatbots #Batch Installation #MCP Service #Automation #Multi - client

rating : 2 points

downloads : 6.7K

update time : 2025-04-28

Open Site

Project Background

As the development environment becomes increasingly complex, it is crucial to configure and manage various IDEs and tools uniformly. This batch installation tool is designed to solve this problem and aims to simplify the deployment process of the Smithery MCP server in a multi - client environment.

Main Features

This tool supports pushing MCP server configurations to multiple target clients at once, significantly improving deployment efficiency. It is compatible with various plugin systems, including GitHub, and provides detailed installation logs to assist in troubleshooting.

Applicable Scenarios

Suitable for development teams, enterprise - level IT departments, and any users who need to configure a unified development environment on multiple devices. By simplifying the deployment process, it helps you save time and reduce human errors.

Batch Installation Tool

Multi - client Support

Push configurations to multiple target clients simultaneously, significantly improving efficiency.

Plugin Compatibility

Built - in support for mainstream plugin systems such as GitHub ensures seamless integration.

Log Recording

Provide detailed installation logs for easy troubleshooting and auditing.

Easy to Extend

The modular design allows for easy addition of new client or plugin support.

🚀 Smithery MCP Batch Installer

A simple bash script for quickly installing the Smithery MCP server on multiple clients simultaneously.

This is a simple bash script designed to quickly install the Smithery MCP server on multiple clients simultaneously. There are currently two versions available:

v1: Accepts a full installation command containing --client cursor.
v2: Only requires specifying the package name (e.g., @mcpserver/openrouterai).

✨ Features

General Features

Automates the process of installing the Smithery MCP server on multiple client applications.
Saves your Smithery key and only changes the target client, enabling efficient deployment in multiple environments.

Version 1 Features

Accepts a full installation command with --client cursor.

Version 2 Features

Supports batch installation by specifying only the package name.
No need to manually enter the full command.
Automatically handles dependencies.
Has a quiet mode (no interaction).

🚀 Quick Start

Version 1

Clone this repository.
Modify the TARGET_CLIENTS array in the batch-installer.sh script to add your desired list of clients.
Run the script:
```
./batch-installer.sh
```
When prompted, paste a full Smithery installation command containing --client cursor.
The script will first execute the command for "cursor" and then install for each client in the list sequentially.
Enter a blank line and press Enter to exit the script.

Version 2

Clone the repository to your local machine.
Download and extract batch-installer-v2.zip.
Run the script:
```
./batch-installer-v2.sh <package-name>
```

Example:

./batch-installer-v2.sh @mcpserver/openrouter

📦 Installation

Prerequisites

Ensure that the script has executable permissions. You can set the permissions using the following command:
```
chmod +x batch-installer.sh
chmod +x batch-installer-v2.sh
```

💻 Usage Examples

Version 1

$ ./batch-installer.sh
Smithery Installation Replicator (Multi-package)
Paste a full Smithery installation command containing `--client cursor`.
Press Enter without input to exit.

Installation command: npx -y @smithery/cli@latest run @smithery-ai/github --client cursor --key d708c05d-f7cc-48ee-907f-e9beb9b9f854
→ Running the original installation command for cursor:
✓ Successfully installed on cursor.
→ Installing on windsurf...
✓ Successfully installed on windsurf.
→ Installing on vscode...
✓ Successfully installed on vscode.
→ Installing on roocode...
✓ Successfully installed on roocode.
→ Installing on witsy...
✓ Successfully installed on witsy.
✔ Installation completed for all clients.

Installation command: 
Completed.

Version 2

$ ./batch-installer-v2.sh @mcpserver/openrouter
Starting batch installation...
Processing the windsurf client:
✓ Successfully installed on windsurf.
Processing the vscode client:
✓ Successfully installed on vscode.
Processing the roocode client:
✓ Successfully installed on roocode.
Processing the witsy client:
✓ Successfully installed on witsy.
Installation completed for all clients, time elapsed: 5 seconds

📚 Documentation

Customizing Target Clients (Version 1)

Edit the TARGET_CLIENTS array in the batch-installer.sh script to add your desired clients:

# Static list of target clients (excluding 'cursor')
TARGET_CLIENTS=("windsurf" "vscode" "roocode" "witsy")

Replace it with your preferred clients:

# Example of a different client list
TARGET_CLIENTS=("vscode" "intellij" "sublime" "atom")

Parameter Explanation (Version 2)

<package-name>: The target package name, e.g., @mcpserver/openrouter.

🔧 Technical Details

How it Works (Version 1)

The script takes a full installation command for the "cursor" client as input.
First, it runs the original command to install on "cursor".
Then, it automatically iterates through a predefined list of clients, replacing "cursor" with each client name.
It confirms after each installation is completed.

📄 License

Not provided in the original document.

⚠️ Important Note

Version 1

The script requires a full installation command containing --client cursor.
Keep the network connection stable during the installation process to ensure smooth downloading of dependencies.

Version 2

Ensure that the script has executable permissions.
If an error occurs, check the network connection or verify that the package name is correct.

This tool greatly simplifies the batch deployment process of the Smithery MCP server and is suitable for both development and production environments.