moling

MoLing is a multi-purpose MCP server that exposes system interaction capabilities over MCP-compatible clients. It can perform file system operations such as reading, writing, merging, statistics, and aggregation, and it can execute system commands directly. It also provides a browser control feature powered by chromedp, which enables automated browser actions (note that Chrome must be installed and accessible on the host). You can connect to MoLing using any supported MCP client (for example Claude, Cline, Cherry Studio, or others) by configuring the client to point at your MoLing server address. The server supports both Stdio and SSE modes for different usage scenarios, including interactive CLI workflows and headless/automated environments.

To use MoLing, start the server and then configure your MCP client with the server address. From the client, you can issue commands to read or manipulate local files, execute shell commands, and perform browser automation tasks via the browser control feature. Be mindful of the security implications of exposing system-level operations through MCP, and restrict access to trusted clients only.

Prerequisites:

• A host machine (Windows, macOS, or Linux) with internet access
• Optional: Go toolchain if you plan to build from source

Option 1: Install via Script (recommended for quick setup)

1. Run the installer script (Linux/macOS):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/gojue/moling/HEAD/install/install.sh)"

2. Follow the prompts to complete installation. The script will download and set up the MoLing server binary.

Option 2: Direct Download

1. Go to the releases page: https://github.com/gojue/moling/releases
2. Download the appropriate package for your OS
3. Extract the package
4. Run the server:

./moling

Option 3: Build from Source

1. Clone the repository:

git clone https://github.com/gojue/moling.git
cd moling

2. Build the project (requires Go toolchain):

make build

3. Run the compiled binary:

./bin/moling

Notes:

• If you install via script or binary, the MoLing server will be available as a standalone executable named moling.
• The server exposes MCP endpoints once running; configure your MCP clients to connect to the server address and port as needed.

Tips and common issues:

• Chrome requirement: The Browser Control feature relies on Chrome. Ensure Chrome is installed and available in your system PATH, especially on Windows where you may need to specify the Chrome path in environment variables.
• Security: Exposing filesystem and command execution can be dangerous. Run MoLing behind access controls and restrict MCP client access to trusted sources.
• Operating system compatibility: MoLing has been primarily tested on macOS. If you run on Windows or Linux, verify path configurations and permissions for the server binary.
• Configuration: The default configuration file will be generated at ~/.moling/config/config.json. You can edit it to customize MCP server behavior and endpoints.
• Automatic client configuration: MoLing can auto-configure MCP clients during installation with moling client --install. This sets up known clients like Claude, Cline, and others.