使用说明

项目简介

'qpd-v_mcp-delete' 是一个基于 Model Context Protocol (MCP) 的服务器,它扩展了大型语言模型(LLM)的能力,使其能够安全地删除本地文件。通过此服务器,你可以让支持 MCP 协议的 AI 助手(如 Claude、VSCode Cline 插件等)执行文件删除操作,从而实现更智能的文件管理和自动化工作流程。

主要功能点

  • 文件删除: 提供 'delete_file' 工具,允许 AI 助手删除指定路径的文件。
  • 路径灵活: 支持相对路径和绝对路径,方便用户指定目标文件。
  • 智能路径解析: 尝试多种路径解析策略,提高文件定位的准确性。
  • 安全检查: 删除文件前进行文件存在性检查,避免误操作。
  • 详细错误信息: 提供清晰的错误提示和路径解析信息,方便问题排查。

安装步骤

  1. 确保你的系统中已安装 Node.js 和 npm (或 npx)。
  2. 打开终端,运行以下命令全局安装 'qpd-v_mcp-delete':
    npm install -g @qpd-v/mcp-delete
    或者,你也可以选择不全局安装,直接使用 'npx' 运行:
    npx @qpd-v/mcp-delete

服务器配置

要让 MCP 客户端(如 Claude Desktop 或 VSCode Cline 插件)连接到 'qpd-v_mcp-delete' 服务器,你需要配置客户端的 MCP 服务器设置。以下是通用的配置信息,你需要将其添加到你的 MCP 客户端的配置文件中。

通用配置信息 (JSON 格式):

{
  "mcpServers": {
    "mcp-delete": {  // 服务器名称,可以自定义,用于在客户端中标识该服务器
      "command": "npx", // 启动服务器的命令,这里使用 npx
      "args": ["@qpd-v/mcp-delete"] // 启动命令的参数,指定要运行的 npm 包
    }
  }
}

注意: 上述配置信息中的 'server name' 可以自定义,'command' 和 'args' 必须按照示例填写。具体的配置文件路径和配置方法请参考你使用的 MCP 客户端的文档。例如,对于 Claude Desktop 和 VSCode Cline,配置文件路径和示例如 README.md 中所示。

基本使用方法

配置完成后,你就可以在支持 MCP 协议的 AI 助手中使用文件删除功能了。例如,在 Claude 中,你可以使用自然语言指令指示其删除文件:

请删除文件 example.txt

AI 助手会将你的指令解析为对 'delete_file' 工具的调用,并安全地删除指定文件。请确保你了解文件删除操作的风险,并谨慎使用该功能。

信息

分类

数据库与文件