article

README

@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

Delete files using relative or absolute paths
Smart path resolution that tries multiple potential paths
Clear error messages with detailed path resolution information
Safe file existence checks before deletion
Works with Claude and other MCP-compatible AI assistants

Examples

Using with Claude Desktop

Claude Desktop Example

Using with VSCode Roo Cline Extension

VSCode Roo Cline Example

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:

path (string, required): Path to the file to delete (relative to working directory or absolute)

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:

The exact path as provided
Path relative to the current working directory
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

MCP文件删除工具