MCP Delete

🚀 @qpd-v/mcp-delete

A Model Context Protocol (MCP) server that provides file deletion functionality. This server allows AI assistants to securely delete files when needed and supports both relative and absolute paths.

🚀 Quick Start

This is a Model Context Protocol (MCP) server offering file deletion functionality. It enables AI assistants to securely delete files as required, supporting both relative and absolute paths.

✨ Features

• Delete files using relative or absolute paths.
• Intelligent path resolution, attempting multiple potential paths.
• Clear error messages with detailed path resolution information.
• Secure file existence check to confirm file presence before deletion.
• Compatible with Claude and other MCP-compatible AI assistants.

💻 Usage Examples

Usage with Claude Desktop

Usage with VSCode Roo Cline Extension

📦 Installation

Installation via Smithery

To automatically install the file deletion feature for Claude Desktop via Smithery:

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

Manual Installation

npx @qpd-v/mcp-delete

Or install globally:

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

📚 Documentation

Configuration for Claude Desktop

Add the server configuration to your Claude Desktop configuration file:

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"]
    }
  }
}

Configuration for VSCode Extension

Add the server configuration to your Cline settings:

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"]
    }
  }
}

Available Tools

delete_file

Delete the file at the specified path.

Parameters:

• path (string, required): The path of the file to be deleted (relative to the working directory or an absolute path).

Example of usage in Claude:

You can ask me to delete a file like this:
"Please delete the example.txt file."

I will use the delete_file tool to safely remove the file.

Path Resolution

The server intelligently handles path resolution by trying multiple methods:

1. The exact same path as provided.
2. Relative paths.
3. Paths relative to the specified base directory.

Development

To clone the project, install dependencies, and build, run the following commands:

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

Debugging

To debug the project, run:

npm run debug

For debugging information, refer to the Debugging Guide.

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

• qpd-v