使用说明

项目简介

MoLing (魔灵) 是一款本地部署的 MCP (Model Context Protocol) 服务器，它通过简单的配置即可为支持 MCP 协议的 LLM 客户端（如 Claude、Cline、Cherry Studio 等）提供强大的扩展能力。MoLing 专注于提供开箱即用的本地办公自动化功能，无需安装任何依赖，即可在 Windows、Linux 和 macOS 等多平台运行。

主要功能点

文件系统操作: 允许 LLM 安全地读取、写入、合并、统计和聚合本地文件系统中的文件，方便进行文档处理、数据分析等任务。
命令行终端: 使 LLM 能够执行预设的安全的系统命令，例如网络诊断、系统信息查询、文件管理等，提升 LLM 的系统交互能力。
浏览器控制: 集成浏览器自动化能力，LLM 可以通过 MoLing 控制浏览器进行网页浏览、信息抓取、表单填写、网页截图等复杂操作。
跨平台兼容: 无需安装任何依赖，原生可执行文件，支持 Windows、Linux、macOS 多种操作系统，部署简单快捷。
易于配置: 采用 JSON 格式配置，只需少量配置即可快速集成到支持 MCP 协议的 LLM 客户端。

安装步骤

MoLing 提供了多种安装方式，选择适合您的方式即可：

方式一：通过脚本安装 (Linux/macOS 推荐)

打开终端，复制并执行以下命令：

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

方式二：直接下载预编译版本

访问 Releases 页面下载对应您操作系统的安装包。
解压安装包到您希望安装的目录。
运行解压目录中的 'moling' 可执行文件即可启动服务器。

方式三：从源码构建

确保您已安装 Go 语言环境。

克隆仓库到本地：

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

执行以下命令编译项目：
```
make build
```
编译成功后，可执行文件位于 'bin/moling'，运行此文件即可启动服务器。

服务器配置

MoLing 服务器主要通过命令行参数进行配置，无需复杂的配置文件。

对于 MCP 客户端，您需要配置 MoLing 服务器的启动命令和参数，以便客户端能够连接并使用 MoLing 提供的功能。以下是一个配置示例 (JSON 格式)，展示了如何在支持 MCP 客户端中配置 MoLing 服务器：

{
  "mcpServers": {
    "MoLing": {
      "command": "/usr/local/bin/moling",  // MoLing 服务器可执行文件的路径 (请替换为您的实际路径)
      "args": []                           // 启动参数，目前 MoLing 默认配置运行，无需额外参数
    }
  }
}

参数说明:

'command': 必填。指向您下载或编译得到的 'moling' 服务器可执行文件的绝对路径。请根据您的实际安装位置进行修改。
'args': 选填。启动参数列表，目前 MoLing 默认配置即可运行，通常无需额外参数。如果需要修改监听地址或启用 debug 模式，可以在这里添加参数，例如 '["-l", "127.0.0.1:8080", "-d"]'。

注意:

请将 '/usr/local/bin/moling' 替换为您实际的 'moling' 可执行文件路径。
客户端配置中 'server name' 可以自定义，例如 "MoLing" 可以替换为任何您喜欢的名称，例如 "MyLocalServer"。

基本使用方法

启动 MoLing 服务器: 根据您的安装方式，运行 'moling' 可执行文件。服务器启动后，默认在本地监听 MCP 客户端的请求。
配置 MCP 客户端: 在您使用的 LLM 客户端（如 Claude、Cline 等）的设置中，找到 MCP 服务器配置项，按照上述 服务器配置 示例，填入 MoLing 服务器的启动命令和参数。
LLM 调用 MoLing 功能: 配置完成后，您的 LLM 客户端即可通过 MCP 协议调用 MoLing 服务器提供的功能，例如：
- 使用 'read_file' 工具读取本地文件内容。
- 使用 'execute_command' 工具执行系统命令。
- 使用 'browser_navigate'、'browser_screenshot' 等浏览器工具进行网页操作。

具体工具的使用方法，请参考 MoLing 项目仓库中的 'services' 目录下各个服务 ('browser.go', 'command.go', 'file_system.go') 的 Tool 定义和描述。 LLM 会根据 Tool 的描述和参数，智能地调用 MoLing 的功能来完成用户指令。

关键词