Everything MCP Server 使用说明

项目简介

Everything MCP Server 是一个使用 TypeScript 开发的 MCP 服务器,它扩展了大型语言模型(LLM)的能力,使其能够与本地系统进行交互。通过提供一系列预定义的工具,该服务器允许 LLM 执行文件操作、获取系统信息、发起 HTTP 请求以及运行系统命令。这使得 LLM 可以超越其固有的知识边界,访问和操作外部数据与系统功能。

主要功能点

  • 文件系统操作:
    • 'read_file': 读取指定路径文件的内容。
    • 'write_file': 将指定内容写入到指定路径的文件中。
    • 'list_directory': 列出指定目录下文件和子目录,支持递归列出。
  • 系统信息获取:
    • 'system_info': 获取操作系统、CPU、内存、网络接口等系统信息。
  • 网络请求:
    • 'http_request': 发起 HTTP 请求,支持 GET、POST、PUT、DELETE 方法,并允许自定义请求头和请求体。
  • 命令执行:
    • 'run_command': 执行任意系统命令,并返回命令输出结果。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/RonaldDegsa/server-everything.git
    cd server-everything
  2. 安装依赖: 确保已安装 Node.js 和 npm。在项目根目录下运行:
    npm install
  3. 全局安装 MCP SDK (可选): 如果你的 MCP 客户端需要依赖 '@modelcontextprotocol/sdk',可以全局安装:
    npm install -g @modelcontextprotocol/sdk

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Everything MCP Server。请根据你的实际环境调整路径。

{
  "serverName": "EverythingServer",  // MCP 服务器名称,与服务器声明的名称一致
  "command": "node",               // 启动服务器的命令,这里使用 node.js 运行
  "args": [                         // 启动参数
    "./src/index.js"              // 服务器入口文件路径,相对于项目根目录
  ],
  "transport": "stdio"             // 使用标准输入输出 (stdio) 作为传输协议
}

配置参数说明:

  • 'serverName': 服务器在代码中声明的名称 '"EverythingServer"',客户端需要通过此名称识别服务器。
  • 'command': 运行服务器程序的可执行命令,对于 Node.js 服务器,通常是 '"node"'。
  • 'args': 传递给 'command' 的参数数组,这里指定了服务器入口文件 '"./src/index.js"' 的路径。
  • 'transport': MCP 服务器使用的传输协议,此服务器使用标准输入输出,因此配置为 '"stdio"'。

基本使用方法

  1. 启动服务器: 在项目根目录下,运行以下命令启动 Everything MCP Server:

    npm start

    或者直接运行入口文件:

    node src/index.js

    服务器成功启动后,会在控制台输出 'Everything MCP server running on stdio'。

  2. 配置 MCP 客户端: 在你的 MCP 客户端应用中,按照客户端的要求配置服务器连接信息,将上面提供的 JSON 配置信息填入客户端的服务器配置中。

  3. 客户端调用工具: 客户端连接到服务器后,可以列出服务器提供的工具,并调用相应的工具执行操作。例如,客户端可以调用 'read_file' 工具读取文件内容,或调用 'run_command' 工具执行系统命令,并将结果返回给 LLM 进行后续处理。

注意: 'run_command' 工具具有潜在的安全风险,请谨慎使用,并确保在安全可信的环境中运行此服务器。

信息

分类

桌面与硬件