使用说明

项目简介

该项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于文件内容修改。它允许授权的 MCP 客户端(通常是 AI 助手,如 Claude)通过预定义的工具对服务器上的文件进行编辑操作。

主要功能点

  • 添加内容: 在指定行号向文件中插入新内容。
  • 替换内容: 根据目标字符串替换文件中的现有内容。
  • 删除内容: 删除文件中包含目标字符串的行。
  • UTF-8 编码支持: 支持 UTF-8 编码的文件处理。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node Package Manager)。
  2. 全局安装 mcp-server-file-modifier: 打开终端或命令提示符,运行以下命令进行全局安装:
    npm install -g mcp-server-file-modifier
    这会将 'mcp-server-file-modifier' 命令添加到你的系统路径中。

服务器配置

为了让 MCP 客户端(例如 Claude)连接到此 MCP 服务器,你需要提供以下配置信息。客户端会使用这些信息来启动和连接服务器。

{
  "serverName": "FileModifierMCP",
  "command": "mcp-server-file-modifier",
  "args": [],
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': 服务器的名称,可以自定义,用于在客户端标识此服务器。例如 "FileModifierMCP"。
  • 'command': 启动 MCP 服务器的命令。这里是全局安装后可用的命令 'mcp-server-file-modifier'。
  • 'args': 启动命令的参数。此服务器默认在 3000 端口启动,无需额外参数,因此参数列表为空 '[]'。如果需要指定端口或其他配置,可能需要在此处添加参数 (但此仓库默认配置无需参数)。
  • 'transport': MCP 客户端与服务器通信的传输协议。通常使用 'stdio' (标准输入输出)。

注意: MCP 客户端需要能够执行 'mcp-server-file-modifier' 命令。请确保已按照安装步骤全局安装了该工具,并且命令可以在客户端的运行环境中找到。

基本使用方法

  1. 启动 MCP 服务器: 在安装完成后,只需在终端或命令提示符中运行 'mcp-server-file-modifier' 命令即可启动服务器。默认情况下,服务器将在 3000 端口监听连接。
  2. 配置 MCP 客户端: 在你的 MCP 客户端(如 Claude 的集成环境)中,根据上面提供的服务器配置信息,添加一个新的 MCP 服务器连接。
  3. 通过客户端调用工具: 客户端连接成功后,你可以指示 AI 助手使用 'fileModifier' 工具,并指定相应的操作 ('add', 'replace', 'delete') 和参数 ('filePath', 'target', 'newContent', 'lineNumber') 来修改服务器上的文件。具体的工具调用方式取决于 MCP 客户端的界面和指令格式。

示例使用场景:

假设你希望 Claude 助手修改服务器上的 'config.txt' 文件,将 "old setting" 替换为 "new setting"。你需要在客户端指示 Claude 使用 'fileModifier' 工具,并传递如下参数(具体参数格式取决于客户端):

{
  "tool_call": {
    "tool_name": "fileModifier",
    "parameters": {
      "action": "replace",
      "filePath": "/path/to/config.txt",
      "target": "old setting",
      "newContent": "new setting"
    }
  }
}

请根据你的 MCP 客户端的具体文档和界面来了解如何配置和调用 MCP 服务器工具。

信息

分类

开发者工具