🚀 @qpd-v/mcp-delete

一个模型上下文协议（MCP）服务器，提供文件删除功能。该服务器允许AI助手在需要时安全地删除文件，并支持相对路径和绝对路径。

🚀 快速开始

本项目是一个模型上下文协议（MCP）服务器，可让AI助手安全地删除文件，支持相对和绝对路径。下面为你介绍其功能、安装、配置等内容。

✨ 主要特性

• 路径灵活：可使用相对或绝对路径删除文件。
• 智能解析：智能路径解析，尝试多种潜在路径。
• 错误明确：有明确的错误消息，带有详细的路径解析信息。
• 安全检查：安全的文件存在性检查，在删除前确认文件是否存在。
• 兼容性强：可与Claude和其他MCP兼容的AI助手一起使用。

💻 使用示例

与Claude Desktop一起使用

与VSCode Roo Cline扩展一起使用

工具使用示例

基础用法

delete_file 工具可用于删除指定路径的文件。

你可以像这样让我删除一个文件：
"请删除example.txt文件"

我将使用delete_file工具安全地移除该文件。

📦 安装指南

通过Smithery安装

要通过Smithery自动安装Claude Desktop的文件删除功能：

npx -y @smithery/cli install @qpd-v/mcp-delete --client claude

手动安装

npx @qpd-v/mcp-delete

或全局安装：

npm install -g @qpd-v/mcp-delete

📚 详细文档

配置说明

Claude Desktop

将服务器配置添加到你的Claude Desktop配置文件中：

• Windows：

// %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-delete": {
      "command": "npx",
      "args": ["@qpd-v/mcp-delete"]
    }
  }
}

• MacOS：

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-delete": {
      "command": "npx",
      "args": ["@qpd-v/mcp-delete"]
    }
  }
}

VSCode 扩展

将服务器配置添加到你的Cline设置中：

• Windows：

// %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
  "mcpServers": {
    "mcp-delete": {
      "command": "npx",
      "args": ["@qpd-v/mcp-delete"]
    }
  }
}

• MacOS：

// ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
{
  "mcpServers": {
    "mcp-delete": {
      "command": "npx",
      "args": ["@qpd-v/mcp-delete"]
    }
  }
}

路径解析

服务器通过尝试多种方法智能处理路径解析：

1. 与提供的完全相同的路径
2. 相对路径
3. 相对于指定基目录的路径

开发步骤

要克隆项目、安装依赖项和构建，请运行以下命令：

git clone https://github.com/qpd-v/mcp-delete.git
cd mcp-delete
npm install
npm run build

调试方法

要调试项目，请运行：

npm run debug

有关调试信息，请参阅调试指南。

🔧 技术细节

服务器在处理路径解析时，会尝试多种路径方式，包括原路径、相对路径和相对于指定基目录的路径，以确保能准确找到要删除的文件。同时，在删除文件前会进行安全的文件存在性检查，避免误删。

📄 许可证

项目采用MIT许可证。

👨‍💻 作者

• qpd-v