Moling

What is Moling

Moling is a computer-used MCP Server that facilitates system interaction through operating system APIs. It acts as a dependency-free local office automation assistant.

Use cases

Use cases for Moling include automating file management tasks, executing system commands for software development, assisting in document creation, and planning schedules efficiently.

How to use

To use Moling, simply download and run it without any installation of dependencies. It is compatible with various operating systems like Windows, Linux, and macOS, allowing users to perform file system operations and execute system commands directly.

Key features

Key features of Moling include file system operations (reading, writing, merging, statistics, and aggregation), a command-line terminal for executing system commands, and browser control powered by chromedp. Future plans include personal data organization, document writing assistance, schedule planning, and life assistant features.

Where to use

Moling can be used in various fields such as office automation, personal data management, and web automation, making it suitable for both individual users and businesses.

MoLing MCP Server

English | 中文 | 日本語

Introduction

MoLing is a computer-use and browser-use MCP Server that implements system interaction through operating system APIs, enabling file system operations such as reading, writing, merging, statistics, and aggregation, as well as the ability to execute system commands. It is a dependency-free local office automation assistant.

Advantages

[!IMPORTANT]
Requiring no installation of any dependencies, MoLing can be run directly and is compatible with multiple operating systems, including Windows, Linux, and macOS.
This eliminates the hassle of dealing with environment conflicts involving Node.js, Python, Docker and other development environments.

Features

[!CAUTION]
Command-line operations are dangerous and should be used with caution.

• File System Operations: Reading, writing, merging, statistics, and aggregation
• Command-line Terminal: Execute system commands directly
• Browser Control: Powered by github.com/chromedp/chromedp
  • Chrome browser is required.
  • In Windows, the full path to Chrome needs to be configured in the system environment variables.
• Future Plans:
  • Personal PC data organization
  • Document writing assistance
  • Schedule planning
  • Life assistant features

[!WARNING]
Currently, MoLing has only been tested on macOS, and other operating systems may have issues.

Supported MCP Clients

• Claude
• Cline
• Cherry Studio
• etc. (who support MCP protocol)

Demos

https://github.com/user-attachments/assets/229c4dd5-23b4-4b53-9e25-3eba8734b5b7

MoLing in Claude

Configuration Format

MCP Server (MoLing) configuration

The configuration file will be generated at /Users/username/.moling/config/config.json, and you can modify its
contents as needed.

If the file does not exist, you can create it using moling config --init.

MCP Client configuration

For example, to configure the Claude client, add the following configuration:

[!TIP]

Only 3-6 lines of configuration are needed.

Claude config path: ~/Library/Application\ Support/Claude/claude_desktop_config

{
  "mcpServers": {
    "MoLing": {
      "command": "/usr/local/bin/moling",
      "args": []
    }
  }
}

and, /usr/local/bin/moling is the path to the MoLing server binary you downloaded.

Automatic Configuration

run moling client --install to automatically install the configuration for the MCP client.

MoLing will automatically detect the MCP client and install the configuration for you. including: Cline, Claude, Roo
Code, etc.

Operation Modes

• Stdio Mode: CLI-based interactive mode for user-friendly experience
• SSE Mode: Server-Side Rendering mode optimized for headless/automated environments

Installation

Option 1: Install via Script

Linux/MacOS

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

Windows

[!WARNING]
Not tested, unsure if it works.

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/gojue/moling/HEAD/install/install.ps1 | iex"

Option 2: Direct Download

1. Download the installation package from releases page
2. Extract the package
3. 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 Golang toolchain):

make build

3. Run the compiled binary:

./bin/moling

Usage

After starting the server, connect using any supported MCP client by configuring it to point to your MoLing server address.

License

Apache License 2.0. See LICENSE for details.