File Deletion is an MCP server that provides secure file deletion capabilities for AI assistants. It enables safe removal of files from the filesystem with intelligent path handling and built-in safety checks. Key features: - Delete files using relative or absolute paths - Smart path resolution that attempts multiple potential locations to locate target files - File existence verification before deletion to prevent errors - Detailed error messages with path resolution information for troubleshooting - Compatible with Claude Desktop, VSCode Roo Cline, and other MCP-compatible AI assistants

@qpd-v/mcp-delete

A Model Context Protocol (MCP) server that provides file deletion capabilities. This server allows AI assistants to safely delete files when needed, with support for both relative and absolute paths.

Features

Examples

Using with Claude Desktop

Using with VSCode Roo Cline Extension

Installation

Installing via Smithery

To install File Deletion for Claude Desktop automatically 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

Configuration

Claude Desktop

Add the server configuration to your Claude Desktop config 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"]
    }
  }
}
}

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

Deletes a file at the specified path.

Parameters:

Example usage in Claude:

You can ask me to delete a file like this:
"Please delete the file example.txt"
I will use the delete_file tool to safely remove the file.

Path Resolution

The server intelligently handles path resolution by trying multiple approaches: 1. The exact path as provided 2. Path relative to the current working directory 3. Path relative to a specified base directory

This makes it more user-friendly as files can be referenced by relative paths and the server will attempt to locate them correctly.

Development

Clone the repository:

git clone https://github.com/qpd-v/mcp-delete.git
cd mcp-delete

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector for debugging:

npm run inspector

This will provide a URL to access debugging tools in your browser.

License

MIT

Author

qpd-v