文件修改 MCP 服务器

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于文件内容的修改。它提供了一组工具，允许 MCP 客户端（如 Claude 等 LLM 应用）通过标准化的 MCP 协议远程修改服务器上的文件内容。

主要功能点

添加内容: 在指定行号向文件中添加新内容。
替换内容: 替换文件中匹配特定目标的内容。
删除内容: 删除文件中包含特定目标的内容行。
UTF-8 编码支持: 支持 UTF-8 编码的文件。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node Package Manager)。你可以从 nodejs.org 下载并安装。
全局安装 mcp-server-file-modifier: 打开终端或命令提示符，运行以下命令全局安装该 MCP 服务器：
```
npm install -g mcp-server-file-modifier
```

服务器配置

为了让 MCP 客户端能够连接到此服务器，你需要提供服务器的配置信息。以下是一个 JSON 格式的配置示例，你需要在 MCP 客户端中进行配置：

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

配置参数说明:

'serverName': 服务器的名称，可以自定义，例如 "fileModifier"。
'command': 启动服务器的命令，这里是全局安装后可直接执行的命令 'mcp-server-file-modifier'。
'args': 启动命令的参数，本服务器默认不需要额外参数，所以为空数组 '[]'。
'transport': 传输协议，默认为 'stdio' (标准输入输出)。

基本使用方法

启动服务器: 在终端或命令提示符中运行 'mcp-server-file-modifier' 命令启动服务器。服务器默认会在 3000 端口监听。你将在终端看到 "File Modifier MCP Server running on port 3000" 的提示信息。
配置 MCP 客户端: 在你的 MCP 客户端 (例如 Claude 的集成环境或支持 MCP 协议的应用) 中，配置上述提供的服务器配置信息。

调用工具: 在 MCP 客户端中，你可以通过指定工具名称 'fileModifier' 和相应的参数来调用文件修改功能。例如，你可以定义一个 Prompt 模板，让 LLM 根据用户指令生成调用 'fileModifier' 工具的请求，实现文件内容的修改。

例如，一个可能的工具调用请求 (JSON-RPC 格式) 可能是这样的 (这只是一个示例，实际请求格式取决于 MCP 客户端的具体实现):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "tool_name": "fileModifier",
    "tool_arguments": {
      "action": "add",
      "filePath": "/path/to/your/file.txt",
      "lineNumber": 5,
      "newContent": "This is the content to add."
    }
  },
  "id": 1
}

你需要参考 MCP 客户端的文档，了解如何构造和发送工具调用请求。

注意: 请确保 MCP 服务器运行的机器可以访问需要修改的文件路径。

关键词

文件修改 MCP 服务器

信息